Date: Fri, 29 Mar 2024 10:41:36 +0000 (UTC) Message-ID: <1870710008.11825.1711708896162@catch-kbase-p> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_11824_1156962430.1711708896161" ------=_Part_11824_1156962430.1711708896161 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
Resource representing a single organisation. Currently Enterprise Tester= only supports a single organisation, so the unique orgranisation identifie= r can be omitted to return the default project when interacting with this r= esource.
This resource supports the following methods: DELETE, GET, PUT
Start a background task to delete a organisation
These are the expected status codes returned by the service. In addition= , some other status codes may be returned if either an internal error occur= s or there is an authentication issue (such as an expired OAuth token).
Status | Description |
---|---|
202 - Accepted | Returned if the task was started successfully.= td> |
404 - NotFound | Returned if project was not found. |
Retrieves information about a single organisation.
For more details on expansions, please see the Expand help topic.
These are the expected status codes returned by the service. In addition= , some other status codes may be returned if either an internal error occur= s or there is an authentication issue (such as an expired OAuth token).
Status | Description |
---|---|
200 - OK | Returned if the request was completed successful= ly. |
404 - NotFound | Returned if organisation was not found. |
Retrieve organisation identified by its unique identifier.
Request Headers
Key | Value | Description |
---|---|---|
Accept | application/json |
Request Parameters
Key | Value | Description |
---|---|---|
{id} | A84DE3D2-6B49-41C4-AD1D-C937338B0E31 | Unique identifier of organisation. |
Response Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json; charset=3Dutf-8 |
Response Body
{ "Id": "a84de3d2-6b49-41c4-ad1d-c937338b0e31", "Name": "Acme Inc", "OrderNumber": 1, "ShortDescription": "Acme Inc make products", "LongDescription": "Acme Inc make products large and small, for many vert= icals and horizontals.", "IndustryType": "Generics", "Expands": [ "Components", "IncidentResolutions", "IncidentStatuses", "IncidentTypes", "Priorities", "ProjectCategories", "Projects", "RequirementDifficulties", "RequirementStatuses", "RequirementTypes", "Statuses", "TestTypes", "Versions" ], "Self": "http://localhost/api/organisation/a84de3d2-6b49-41c4-ad1d-c93733= 8b0e31" }
Status Code
200 - OK
Retrieves the default organisation by omitting any unique identifier (Cu= rrently all Enterprise Tester installations have a maximum of 1 organisatio= n, so this will return the only organisation).
Request Headers
Key | Value | Description |
---|---|---|
Accept | application/json |
Response Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json; charset=3Dutf-8 |
Response Body
{ "Id": "a84de3d2-6b49-41c4-ad1d-c937338b0e31", "Name": "Acme Inc", "OrderNumber": 1, "ShortDescription": "Acme Inc make products", "LongDescription": "Acme Inc make products large and small, for many vert= icals and horizontals", "IndustryType": "Generics", "Expands": [ "Components", "IncidentResolutions", "IncidentStatuses", "IncidentTypes", "Priorities", "ProjectCategories", "Projects", "RequirementDifficulties", "RequirementStatuses", "RequirementTypes", "Statuses", "TestTypes", "Versions" ], "Self": "http://localhost/api/organisation/a84de3d2-6b49-41c4-ad1d-c93733= 8b0e31" }
Status Code
200 - OK
Update details for an organisation.
For more details on expansions, please see the Expand help topic.
These are the expected status codes returned by the service. In addition= , some other status codes may be returned if either an internal error occur= s or there is an authentication issue (such as an expired OAuth token).
Status | Description |
---|---|
200 - OK | Returned if the request was completed successful= ly. |
403 - Forbidden | Returned if request can not be satisified (inval= id values, or insufficient permissions). |
404 - NotFound | Returned if organisation was not found. |
Update organisation details.
Request Headers
Key | Value | Description |
---|---|---|
Accept | application/json |
Request Body
{ "Name": "XYZ Corp", "OrderNumber": 2, "ShortDescription": "XYZ Corp integrate systems", "LongDescription": "XYZ Corp can integrate any X with any Y to make a Z", "IndustryType": "Integration" }
Response Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json; charset=3Dutf-8 |
Response Body
{ "Id": "a84de3d2-6b49-41c4-ad1d-c937338b0e31", "Name": "XYZ Corp", "OrderNumber": 2, "ShortDescription": "XYZ Corp integrate systems", "LongDescription": "XYZ Corp can integrate any X with any Y to make a Z", "IndustryType": "Integration", "Expands": [ "Components", "IncidentResolutions", "IncidentStatuses", "IncidentTypes", "Priorities", "ProjectCategories", "Projects", "RequirementDifficulties", "RequirementStatuses", "RequirementTypes", "Statuses", "TestTypes", "Versions" ], "Self": "http://localhost/api/organisation/a84de3d2-6b49-41c4-ad1d-c93733= 8b0e31" }
Status Code
200 - OK