Get Organization

GET/api/v2/admin/organizations/{organizationRid}

Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Get the Organization with the specified rid.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:admin-read.

Path parameters

organizationRid

string

Query parameters

preview

boolean

optional

Enables the use of preview functionality.

Response body

Organization

object

Hide child attributes

rid

string

name

string

description

string

optional

markingId

string

The ID of this Organization's underlying marking. Organization guest access can be managed by updating the membership of this Marking.

host

string

optional

The primary host name of the Organization. This should be used when constructing URLs for users of this Organization.

Examples

Request

Copied!

curl \
	-H "Authorization: Bearer $TOKEN" \
	"https://$HOSTNAME/api/v2/admin/organizations/ri.multipass..organization.c30ee6ad-b5e4-4afe-a74f-fe4a289f2faa?preview=true"

Response

Copied!

{
  "name": "Example Organization",
  "host": "example.palantirfoundry.com",
  "rid": "ri.multipass..organization.c30ee6ad-b5e4-4afe-a74f-fe4a289f2faa",
  "markingId": "18212f9a-0e63-4b79-96a0-aae04df23336"
}

Error responses

Error Name
`OrganizationNotFound`	Error Code	`NOT_FOUND`
	Status Code	404
	Description	The given Organization could not be found.
	Parameters	`organizationRid`

See Errors for a general overview of errors in the platform.