# VictorOps API

> VictorOps API on Apizie: 68 endpoints (Retrieve alert details., Get current incident information, Create a new incident, Acknowledge an incident or list of incidents, …) returned as clean JSON through one API key. 68 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/dev-tools:victorops/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:victorops`
- Category: Dev Tools
- Status: live
- Source: https://victorops.com
- Page: https://zieapi.vercel.app/api/dev-tools/victorops
- OpenAPI: https://zieapi.vercel.app/api/dev-tools/victorops/openapi.json

This API allows you to interact with the VictorOps platform in various ways. Your account may be limited to a total number of API calls per month. Also, some of these API calls have rate limits. NOTE: In this…

## Endpoints

### Retrieve alert details.
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-alerts-uuid`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| uuid | string | yes | The VictorOps uuid of the alert |

### Get current incident information
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-incidents`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Create a new incident
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-incidents`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Acknowledge an incident or list of incidents
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/patch-api-public-v1-incidents-ack`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Acknowledge all incidents for which a user was paged.
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/patch-api-public-v1-incidents-by-user-ack`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Resolve all incidents for which a user was paged.
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/patch-api-public-v1-incidents-by-user-resolve`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Reroute one or more incidents to one or more new routable destinations.
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-incidents-reroute`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Resolve an incident or list of incidents
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/patch-api-public-v1-incidents-resolve`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Get an organization's current maintenance mode state
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-maintenancemode`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Start maintenance mode for routing keys
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-maintenancemode-start`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### End maintenance mode for routing keys
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/put-api-public-v1-maintenancemode-maintenancemodeid-end`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| maintenancemodeid | string | yes | The id of the maintenance mode found in the active maintenance mode object |

### Get an organization's on-call users
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-oncall-current`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### List routing keys with associated teams
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-org-routing-keys`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### List the scheduled overrides
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-overrides`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Creates a new scheduled override
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-overrides`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Get the specified scheduled override
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-overrides-public-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| publicId | string | yes | The publicId of the scheduled override |

### Deletes a scheduled override
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/delete-api-public-v1-overrides-public-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| publicId | string | yes | The publicId of the scheduled override |

### Get the specified scheduled override
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-overrides-public-id-assignments`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| publicId | string | yes | The publicId of the scheduled override |

### Get the specified scheduled override assignment
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-overrides-public-id-assignments-policy-slu`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| publicId | string | yes | The publicId of the scheduled override |
| policySlug | string | yes | The policySlug of the assignment |

### Update the scheduled override assignment
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/put-api-public-v1-overrides-public-id-assignments-policy-slu`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| publicId | string | yes | The publicId of the scheduled override |
| policySlug | string | yes | The policySlug of the assignment |
| body | object | yes | JSON request body |

### Delete the scheduled override assignment
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/delete-api-public-v1-overrides-public-id-assignments-policy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| publicId | string | yes | The publicId of the scheduled override |
| policySlug | string | yes | The policySlug of the assignment |

### Get escalation policy info
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-policies`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Get the available contact types
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-policies-types-contacts`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Get the available notification types
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-policies-types-notifications`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Get the available timeout values
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-policies-types-timeouts`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Create an on-call override (take on-call)
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/patch-api-public-v1-policies-policy-oncall-user`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| policy | string | yes | The VictorOps policy 'slug' |
| body | object | yes | JSON request body |

### Get the user's paging policy
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-profile-username-policies`

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | Your username |
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Create a paging policy step
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-profile-username-policies`

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | Your username |
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Get a paging policy step
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-profile-username-policies-step`

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | Your username |
| step | number | yes | Paging policy step |
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Create a rule for a paging policy step
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-profile-username-policies-step`

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | Your username |
| step | number | yes | Paging policy step |
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Update a paging policy step
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/put-api-public-v1-profile-username-policies-step`

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | Your username |
| step | number | yes | Paging policy step |
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Get a rule from a paging policy step
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-profile-username-policies-step-rule`

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | Your username |
| step | number | yes | Paging policy step |
| rule | number | yes | Rule for a paging policy step |
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Update a rule for a paging policy step
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/put-api-public-v1-profile-username-policies-step-rule`

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | Your username |
| step | number | yes | Paging policy step |
| rule | number | yes | Rule for a paging policy step |
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Delete a rule from a paging policy step
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/delete-api-public-v1-profile-username-policies-step-rule`

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | yes | Your username |
| step | number | yes | Paging policy step |
| rule | number | yes | Rule for a paging policy step |
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### List teams
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-team`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Add a team
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-team`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Retrieve information for a team
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-team-team`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team to fetch |

### Update a team
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/put-api-public-v1-team-team`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team to be updated |
| body | object | yes | JSON request body |

### Remove a team
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/delete-api-public-v1-team-team`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team to be deleted |

### Retrieve a list of team admins for a team
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-team-team-admins`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team |

### Retrieve a list of members for a team
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-team-team-members`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team to fetch |

### Add a team member
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-team-team-members`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team to fetch |
| body | object | yes | JSON request body |

### Remove a team member
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/delete-api-public-v1-team-team-members-user`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team to be deleted |
| user | string | yes | The team member username |
| body | object | yes | JSON request body |

### Retrieve a list of escalation policies for a team
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-team-team-policies`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team to fetch |

### List users
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |

### Add a user
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-user`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| body | object | yes | JSON request body |

### Retrieve information for a user
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user to fetch |

### Update a user
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/put-api-public-v1-user-user`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user to be updated |
| body | object | yes | JSON request body |

### Remove a user
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/delete-api-public-v1-user-user`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user to be deleted |
| body | object | yes | JSON request body |

### Get a list of all contact methods for a user
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user-contact-methods`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |

### Get a list of all contact devices for a user
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user-contact-methods-devices`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |

### Get the indicated contact device for a user
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user-contact-methods-devices-contact`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| contactId | string | yes | The unique contact identifier |

### Update a contact device for a user
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/put-api-public-v1-user-user-contact-methods-devices-contact`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| contactId | string | yes | The unique contact identifier |
| body | object | yes | JSON request body |

### Delete a contact device for a user
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/delete-api-public-v1-user-user-contact-methods-devices-conta`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| contactId | string | yes | The unique contact identifier |

### Get a list of all contact emails for a user
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user-contact-methods-emails`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |

### Create a contact emails for a user
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-user-user-contact-methods-emails`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| body | object | yes | JSON request body |

### Get the indicated contact email for a user
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user-contact-methods-emails-contact-i`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| contactId | string | yes | The unique contact identifier |

### Delete a contact email for a user
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/delete-api-public-v1-user-user-contact-methods-emails-contac`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| contactId | string | yes | The unique contact identifier |

### Get a list of all contact phones for a user
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user-contact-methods-phones`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |

### Create a contact phones for a user
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/post-api-public-v1-user-user-contact-methods-phones`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| body | object | yes | JSON request body |

### Get the indicated contact phone for a user
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user-contact-methods-phones-contact-i`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| contactId | string | yes | The unique contact identifier |

### Delete a contact phone for a user
`POST https://zieapi.vercel.app/v1/dev-tools:victorops/delete-api-public-v1-user-user-contact-methods-phones-contac`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| contactId | string | yes | The unique contact identifier |

### Get a list of paging policies for a user
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user-policies`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |

### Retrieve the user's team membership
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-user-user-teams`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user |

### Get a team's on-call schedule
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v2-team-team-oncall-schedule`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team 'slug' |
| daysForward | number | no | Days to include in returned schedule (30 max) |
| daysSkip | number | no | Days to skip before computing schedule to return (90 max) |
| step | number | no | Step of escalation policy (3 max) |

### Get a user's on-call schedule
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v2-user-user-oncall-schedule`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| user | string | yes | The VictorOps user ID |
| daysForward | number | no | Days to include in returned schedule (30 max) |
| daysSkip | number | no | Days to skip before computing schedule to return (90 max) |
| step | number | no | Step of escalation policy (3 max) |

### A list of shift changes for a team
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-reporting-v1-team-team-oncall-log`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| team | string | yes | The VictorOps team 'slug' |
| start | string | no | Return shift changes occurring after this timestamp. The default is the start of the day at midnight. Specify the timestamp in ISO8601… |
| end | string | no | Return shift changes occurring before this timestamp. The default is the end of the day at 11:59:59. Specify the timestamp in ISO8601 format |
| userName | string | no | The VictorOps user ID. Return shift changes occurring during the interval specified for this user. Without this parameter, all relevant… |

### Get/search incident history
`GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-reporting-v2-incidents`

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-VO-Api-Id | string | yes | Your API ID |
| X-VO-Api-Key | string | yes | Your API Key |
| offset | number | no | The offset within the set of matching incidents |
| limit | number | no | The maximum number of matching incidents to return (100 max) |
| entityId | string | no | The entity ID involved This is the unique identifier for the entity causing the incident. |
| incidentNumber | string | no | The incident number as shown in VictorOps Multiple values and ranges are allowed: 4,5,20:50 |
| startedAfter | string | no | Return incidents started after this timestamp Specify the timestamp in ISO8601 format |
| startedBefore | string | no | Find incidents started before this timestamp Specify the timestamp in ISO8601 format |
| host | string | no | The host involved in the incident Multiple values can be separated with commas. |
| service | string | no | The service involved in the incident (if any) Multiple values can be separated with commas. |
| currentPhase | string | no | The current phase of the incident "resolved", "triggered" or "acknowledged". Multiple values can be separated with commas. By default,… |
| routingKey | string | no | The original routing of the incident |

## Example
```
curl "https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-alerts-uuid" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the VictorOps API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/dev-tools:victorops/get-api-public-v1-alerts-uuid with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the VictorOps API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the VictorOps API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key dev-tools:victorops.

### What is the status of the VictorOps API?
Live: works with just an Apizie key