Skip to main content

Get My Instance

GET 

https://$CUSTOM-DOMAIN/admin/v1/instances/me

deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Deprecated: use instance service v2 GetInstance instead.

Returns the details about the current instance such as the name, version, domains, etc.

Responses​

A successful response.

Schema
    instance object
    idstring
    Example: 69629023906488334
    details object
    sequenceuint64

    on read: the sequence of the last event reduced by the projection

    on manipulation: the timestamp of the event(s) added by the manipulation

    Example: 2
    creationDatedate-time

    on read: the timestamp of the first event of the object

    on create: the timestamp of the event(s) added by the manipulation

    changeDatedate-time

    on read: the timestamp of the last event reduced by the projection

    on manipulation: the

    resourceOwnerresource_owner is the organization an object belongs to (string)
    Example: 69629023906488334
    statestring

    current state of the instance

    Possible values: [STATE_UNSPECIFIED, STATE_CREATING, STATE_RUNNING, STATE_STOPPING, STATE_STOPPED]

    Default value: STATE_UNSPECIFIED
    namestring
    Example: ZITADEL
    versionstring
    Example: 1.0.0
    domains object[]
  • Array [
  • details object
    sequenceuint64

    on read: the sequence of the last event reduced by the projection

    on manipulation: the timestamp of the event(s) added by the manipulation

    Example: 2
    creationDatedate-time

    on read: the timestamp of the first event of the object

    on create: the timestamp of the event(s) added by the manipulation

    changeDatedate-time

    on read: the timestamp of the last event reduced by the projection

    on manipulation: the

    resourceOwnerresource_owner is the organization an object belongs to (string)
    Example: 69629023906488334
    domainstring
    Example: zitadel.com
    primaryboolean
    generatedboolean
  • ]

Authorization: oauth2

name: OAuth2type: oauth2scopes: openid,urn:zitadel:iam:org:project:id:zitadel:audflows: {
  "authorizationCode": {
    "authorizationUrl": "$CUSTOM-DOMAIN/oauth/v2/authorize",
    "tokenUrl": "$CUSTOM-DOMAIN/oauth/v2/token",
    "scopes": {
      "openid": "openid",
      "urn:zitadel:iam:org:project:id:zitadel:aud": "urn:zitadel:iam:org:project:id:zitadel:aud"
    }
  }
}
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://$CUSTOM-DOMAIN/admin/v1/instances/me");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
Request Collapse all
Base URL
https://$CUSTOM-DOMAIN/admin/v1
Auth
ResponseClear

Click the Send API Request button above and see the response here!