HTTP Verb: POST

Available statuses: 201 Created, 422 Unprocessable Entity, 404 Not Found

Object: StandupReport

Location: n/a

Formats: XML, JSON

Create or if an away standup report for specified date(today by default) is already created, update the standup report. If no date is specified, an away standup report will be created for today.

Params

To create an away standup report a data body must be provided. Data can be provided in three formats: XML, JSON and query string. To specify data type of XML or JSON add the Content-type: application/(json|xml) header to request headers, if you want to provide query string simply skip the Content-type header.

All params should be sent in the standup_report namespace, e.g.:

XML

<standup_report>
  <what_i_will_do>Vacation</what_i_will_do>
  ...
</standup_report>

JSON

{"standup_report":{"what_i_will_do":"Vacation",...}}

Query string

standup_report[what_i_will_do]=Vacation&...

Check the full list of available params on standup report object fields reference

Additional parameters:

Param Description
date The date standup reports will be displayed for. Available formats: dd/mm/yyyy, dd.mm.yyyy, dd-mm-yyyy, yyyy/mm/dd, yyyy.mm.dd, yyyy-mm-dd

Examples

For example purposes we use a JSON body.

{"standup_report":{"what_i_will_do":"Vacation"}}

Request JSON, using cURL utility:

curl -i -H "Authorization: Bearer _token" -H "Accept: application/json" -d '{"standup_report":{"what_i_will_do":"Vacation"}}' https://api.assembla.com/v1/spaces/_space_id/away_standup_report.json

Response

HTTP/1.1 201 Created
Server: nginx/0.7.68
Date: Tue, 24 Jul 2012 13:46:06 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 201
Location: https://api.assembla.com/v1/spaces/_space_id/away_standup_report
...

{
  "what_i_will_do":"Vacation",
  "space_id":"c7s6iqyBWr4kvosfS5feCJ",
  "roadblocks":null,
  "updated_at":"2012-07-24 13:43:09 UTC",
  "user_id":"bFJYdsqlur4kBCsfS5feCJ",
  "what_i_did":null,
  "away_flag":true,
  "filled_for":"2012-07-24",
  "created_at":"2012-07-24 13:43:09 UTC"
}

JSON is formatted here for readability, in a real response JSON body is inline with no indentation.

Request XML, using cURL utility:

curl -i -H "Authorization: Bearer _token" -H "Accept: application/json" -d '{"standup_report":{"what_i_will_do":"Vacation"}}' https://api.assembla.com/v1/spaces/_space_id/away_standup_report.xml

Response

HTTP/1.1 201 Created
Server: nginx/0.7.68
Date: Tue, 24 Jul 2012 13:43:10 GMT
Content-Type: application/xml; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 201
Location: http://api.assembla.com/v1/spaces/_space_id/away_standup_report
...

<?xml version="1.0" encoding="UTF-8"?>
<standup-report>
  <space-id>c7s6iqyBWr4kvosfS5feCJ</space-id>
  <what-i-will-do>Vacation</what-i-will-do>
  <roadblocks nil="true"></roadblocks>
  <away-flag type="boolean">true</away-flag>
  <created-at>2012-07-24 13:43:09 UTC</created-at>
  <updated-at>2012-07-24 13:43:09 UTC</updated-at>
  <filled-for>2012-07-24</filled-for>
  <what-i-did nil="true"></what-i-did>
  <user-id>bFJYdsqlur4kBCsfS5feCJ</user-id>
</standup-report>

Note: pay attention to Location header, this is the URL where newly created resource is located, you can GET on this URL to access this resource.

Description for each field: standup report object fields reference