GET /v1/invitations/:id
HTTP Verb: GET
Available statuses: 200 OK, 404 Not Found
Object: User Role
Location: n/a
Formats: XML, JSON
Returns an invitation (user role) by id.
Params
Not available
Examples
Request XML, using cURL utility:
curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/invitations/_id.xml?portfolio=_portfolio_subdomain
Response:
HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Fri, 07 Sep 2012 13:08:42 GMT
Content-Type: application/xml; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...
<?xml version="1.0" encoding="UTF-8"?>
<user-role>
<id type="integer">328</id>
<user-id>cqKiiGWBKr4Oo-5bfBjDYC</user-id>
<space-id>cJiq3KDNyr4PMj5bfBjDYC</space-id>
<role>member</role>
<status type="integer">1</status>
<invited-time type="datetime">2013-05-27T00:30:49-05:00</invited-time>
<agreed-time nil="true"></agreed-time>
<title nil="true"></title>
<invited-by-id>dd_iFeDNur4PMj5bfBjDYC</invited-by-id>
</user-role>
Request JSON, using cURL utility:
curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/invitations/_id.json?portfolio=_portfolio_subdomain
Response:
HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Fri, 07 Sep 2012 13:12:30 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...
{
"id": 328,
"user_id": "cqKiiGWBKr4Oo-5bfBjDYC",
"space_id": "cJiq3KDNyr4PMj5bfBjDYC",
"role": "member",
"status": 1,
"invited_time": "2013-05-27T00:30:49-05:00",
"agreed_time": null,
"title": null,
"invited_by_id": "dd_iFeDNur4PMj5bfBjDYC"
}
JSON is formatted here for readability, in a real response JSON body is inline with no indentation.
Description for each field: User role object fields reference