POST /v1/spaces/:space_id/away_standup_report
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