# Manage organization API key status

div
strong
🔨 In Development
 — This section is still being developed and may change.


Activate, deactivate, pause, or unpause organization API keys without modifying other metadata. These endpoints help teams react quickly to security incidents or operational needs.

## Available endpoints

| Action | Method & Path |
|  --- | --- |
| Activate key | `POST /v1/organizations/{organization_id}/api/{api_key_id}/activate` |
| Deactivate key | `POST /v1/organizations/{organization_id}/api/{api_key_id}/deactivate` |
| Pause key | `POST /v1/organizations/{organization_id}/api/{api_key_id}/pause` |
| Unpause key | `POST /v1/organizations/{organization_id}/api/{api_key_id}/unpause` |


All four endpoints share the same structure and optional request body.

#### Path Parameters

**`organization_id`** string required

Organization scope for the API key.

**`api_key_id`** string required

Identifier of the API key to modify (prefixed with `apk_`).

#### Request Body (optional)

**`note`** string optional

Optional audit message explaining why the status changed.

## Returns

Updated key metadata reflecting the new status.


```json
{
  "id": "apk_7f21a9d94e6f48b1",
  "status": "active",
  "isPaused": false,
  "updatedAt": "2025-11-05T10:11:02Z"
}
```

## Request example


```bash
curl -X POST "https://api.freddy.aitronos.com/v1/organizations/ORG_1234567890abcdef/api/apk_7f21a9d94e6f48b1/activate" \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type": "application/json" \
  -d '{
    "note": "Reactivated after security review"
  }'
```


```python
import requests

response = requests.post(
    "https://api.freddy.aitronos.com/v1/organizations/ORG_1234567890abcdef/api/apk_7f21a9d94e6f48b1/activate",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={"note": "Reactivated after security review"}
)

response.raise_for_status()
print(response.json()["status"])
```


```javascript
const response = await fetch(
  'https://api.freddy.aitronos.com/v1/organizations/ORG_1234567890abcdef/api/apk_7f21a9d94e6f48b1/activate',
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ note: 'Reactivated after security review' })
  }
);

if (!response.ok) {
  throw new Error('Failed to change status');
}

const result = await response.json();
console.log(result.status);
```

## Related resources

- [List organization API keys](/docs/api-reference/organizations/management/api-keys/list)
- [Update organization API key](/docs/api-reference/organizations/management/api-keys/update)
- [Get top API usage](/docs/api-reference/organizations/analytics/get-top-api-usage)