POST /v1/spaces/:space_id/standup_reports
HTTP Verb: POST
Available statuses: 201 Created, 422 Unprocessable Entity, 404 Not Found
Object: StandupReport
Location: n/a
Formats: XML, JSON
Create or if a standup report for specified date(today by default) is already created, update the standup report. If no date is specified, a standup report will be created for today.
Params
To create a 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 standup_report namespace, e.g.:
XML
<standup_report>
<what_i_will_do>Work on ticket 369</what_i_will_do>
...
</standup_report>
JSON
{"standup_report":{"what_i_will_do":"Work on ticket 369",...}}
Query string
standup_report[what_i_will_do]=Work+on+ticket+369&...
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":"work"}}
Request JSON, using cURL utility:
curl -i -H "Authorization: Bearer _token" -H "Accept: application/json" -d '{"standup_report":{"what_i_will_do":"work"}}' https://api.assembla.com/v1/spaces/_space_id/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: http://api.assembla.com/v1/spaces/_space_id/standup_report
...
{
"what_i_will_do":null,
"space_id":"c7s6iqyBWr4kvosfS5feCJ",
"roadblocks":null,
"updated_at":"2012-07-24 13:43:09 UTC",
"user_id":"bFJYdsqlur4kBCsfS5feCJ",
"what_i_did":null,
"away_flag":false,
"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":"work"}}' https://api.assembla.com/v1/spaces/_space_id/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/standup_report
...
<?xml version="1.0" encoding="UTF-8"?>
<standup-report>
<space-id>c7s6iqyBWr4kvosfS5feCJ</space-id>
<what-i-will-do nil="true"></what-i-will-do>
<roadblocks nil="true"></roadblocks>
<away-flag type="boolean">false</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