GET api/jobroles/{id}
Requires authentication. Get an individual jobrole by GUID. If successful returns "200 OK", with the body of the response containing a representation of the jobrole. If not found, returns "404 Not Found" If CRM operations fail for an un-recoverable reason, the service returns "502 Bad Gateway" Any other server-side errors return "500 Internal Server Error"
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| id | globally unique identifier |
Required |
Body Parameters
None.
Response Information
Resource Description
JobRoleRepresentation
JobRoleRepresentation| Name | Description | Type | Additional information |
|---|---|---|---|
| Id |
Unique identifier - same as in CRM |
globally unique identifier |
None. |
| Name |
Login for this system |
string |
None. |
| Links | Collection of Link |
None. |
Response Formats
application/json, text/json
Sample:
{
"Id": "8854bdb4-e58e-458e-a5f9-e109b53c7914",
"Name": "sample string 2",
"_links": [
{
"Rel": "self",
"Href": "~/jobroles/8854bdb4-e58e-458e-a5f9-e109b53c7914",
"Title": null,
"IsTemplated": false
},
{
"Rel": "sample string 1",
"Href": "sample string 2",
"Title": "sample string 3",
"IsTemplated": false
},
{
"Rel": "sample string 1",
"Href": "sample string 2",
"Title": "sample string 3",
"IsTemplated": false
}
],
"_embedded": null
}
application/xml, text/xml
Sample:
<JobRoleRepresentation xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SSAT.WebServices.WebApp.Representations.Version1">
<Href xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">~/jobroles/8854bdb4-e58e-458e-a5f9-e109b53c7914</Href>
<LinkName xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">sample string 5</LinkName>
<Links xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">
<Link>
<Href>~/jobroles/8854bdb4-e58e-458e-a5f9-e109b53c7914</Href>
<Rel>self</Rel>
<Title i:nil="true" />
</Link>
<Link>
<Href>sample string 2</Href>
<Rel>sample string 1</Rel>
<Title>sample string 3</Title>
</Link>
<Link>
<Href>sample string 2</Href>
<Rel>sample string 1</Rel>
<Title>sample string 3</Title>
</Link>
</Links>
<Rel xmlns="http://schemas.datacontract.org/2004/07/WebApi.Hal">sample string 3</Rel>
<Id>8854bdb4-e58e-458e-a5f9-e109b53c7914</Id>
<Name>sample string 2</Name>
</JobRoleRepresentation>
application/hal+json
Sample:
{
"Id": "8854bdb4-e58e-458e-a5f9-e109b53c7914",
"Name": "sample string 2",
"_links": {
"self": {
"href": "/jobroles/8854bdb4-e58e-458e-a5f9-e109b53c7914"
},
"sample string 1": {
"href": "sample string 2",
"title": "sample string 3"
}
}
}
application/hal+xml
Sample:
<resource rel="sample string 3" href="~/jobroles/8854bdb4-e58e-458e-a5f9-e109b53c7914" name="sample string 5"> <link rel="sample string 1" href="sample string 2" /> <Id>8854bdb4-e58e-458e-a5f9-e109b53c7914</Id> <Name>sample string 2</Name> </resource>