We use cookies (just for analytics) on this website. If you continue we will assume you are happy with it. ok

BeBanjo

Back to index

Note

Notes are generic pieces of information associated to a given job. A note belongs to a job. It has no child resources.

Here is what its XML looks like:

<?xml version='1.0' encoding='utf-8' ?>
<note>
  <body>Expecting more information</body>
  <creator>bebanjo_sfanytime</creator>
  <created-at type='datetime'>2010-12-21T19:31:16+00:00</created-at>
  <link href="https://sequence.example.com/api/work_areas/10/jobs/12875/notes/69837" rel="self"></link>
  <link href="https://sequence.example.com/api/work_areas/10/jobs/12875" rel="job"></link>
</note>

Valid attributes

  • body (text, read/write): This is the body of the note. It can be any text.
  • creator (string, read only): This is the login ID for the user who created the note.
  • created-at (datetime, read only): This is the timestamp when the date was created.

Creating a note

In order to add a note to a specific Job, it is necessary to issue a POST request to the notes list of a Job. The URL for the request would look something like this:

https://sequence.example.com/api/work_areas/10/jobs/27188/notes

The attributes that can be used to create a note are:

  • body (required).

Here is an example using curl:

$ curl --digest -u robot_user -H "Content-Type: application/xml" -d @note.xml https://sequence.example.com/api/work_areas/10/jobs/27188/notes

This line would issue a POST request to the URL specified at the end using digest authentication. It is also setting the HTTP header Content-Type: application/xml (required) and is sending the contents of the file note.xml as the body of the request. This is what the body of the POST request should look like:

<note>
  <body>Original Title: 'Mujeres al Borde de un Ataque de Nervios'</body>
</note>

If successfully created, the response will be the complete XML of the new note with an HTTP status code of 200:

<note>
  <body>Original Title: Mujeres al Borde de un Ataque de Nervios</body>
  <creator>robot_user</creator>
  <created-at type="datetime">2010-12-21T19:36:15+00:00</created-at>
  <link href="https://sequence.example.com/api/work_areas/10/jobs/27188/notes/69388" rel="self"></link>
  <link href="https://sequence.example.com/api/work_areas/10/jobs/27188" rel="job"></link>
</note>

Updating a note

It is currently not possible to update a note.

Deleting a note

In order to DELETE a note, it is only necessary to issue a DELETE request to the note URL, like so:

$ curl --digest -u robot_user -H "Content-Type: application/xml" -X DELETE https://sequence.example.com/api/work_areas/10/jobs/27188/notes/69388

The response should be a 204 (no content) HTTP Status code, with no body.

Last updated July 07th, 2017.