---
title: endpointDeployToken query | Wartiva GraphQL API
description: Returns the deployment token and secret that enroll newly installed Wartiva agents into an Organization. Wartiva GraphQL API reference with examples.
url: https://wartiva.com/api-docs/queries/endpoint-deploy-token.html
updated: 2026-10-07
---

Organizations and users · GraphQL query

# `endpointDeployToken` query

Returns the deployment token and secret that enroll newly installed Wartiva agents into an [Organization](https://wartiva.com/api-docs/types/organization.html). The first call for an organization creates the secret; later calls return the same one. Treat the result as a credential: anyone holding it can enroll endpoints into the organization. Restricted to organization administrators, and fails when the organization has no deployment address configured.

## Response

Returns an [`EndpointDeployTokenPayload!`](https://wartiva.com/api-docs/types/endpoint-deploy-token-payload.html)

## Arguments

| Name | Description |
|---|---|
| `orgId` - [`OrganizationId!`](https://wartiva.com/api-docs/types/organization-id.html) | The Organization identifier. |

## Example

### Query

```graphql
query endpointDeployToken($orgId: OrganizationId!) {
  endpointDeployToken(orgId: $orgId) {
    orgId
    token
    deploymentAddress
  }
}

```

### Variables

```json
{"orgId": "615f3b3b28284380e28a7342"}

```

### Response

```json
{
  "data": {
    "endpointDeployToken": {
      "orgId": "615f3b3b28284380e28a7342",
      "token": "xyz789",
      "deploymentAddress": "abc123"
    }
  }
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt