{"type":"api","title":"Regenerate API token","meta":{"id":"/apps/pubhub/media/000-v7-apis/78f449d7e4ba5c2367359378827403d23edb1885/dd92fac8-aef9-3ecd-814c-3bda2fdaeba0","info":{"description":"Manage your ThousandEyes OpenAPI bearer token.","title":"API Token Management API","version":"7.0.63"},"security":[{"BearerAuth":[]}],"tags":[{"name":"API Token"}],"openapi":"3.0.1","servers":[{"description":"ThousandEyes API production URL","url":"https://api.thousandeyes.com/v7"}],"securitySchemes":{"BearerAuth":{"description":"Bearer authentication token","scheme":"bearer","type":"http"}}},"spec":{"description":"Regenerates the bearer token for your account.\n\n\n- Requires a valid, non-expired bearer token. \n\n- The new token is valid for 2 years. \n\n- After regeneration, the previous token remains valid for 14 days, or until its scheduled expiration date, whichever comes first. \n\n- You can regenerate a new token only if your account has a single active token. Attempts to regenerate more than one new token within the 14-day overlap period returns a 409 error.\n\n\nUpdate your applications to use the new token immediately.\n","operationId":"regenerateApiToken","responses":{"201":{"content":{"application/hal+json":{"schema":{"properties":{"bearerToken":{"description":"The API token for your account.","example":"123e4567-e89b-12d3-a456-426614174000","readOnly":true,"type":"string"},"validUntil":{"description":"The date and time when the generated API token will expire.","example":"2024-12-31T23:59:59Z","format":"date-time","readOnly":true,"type":"string"}},"type":"object","$$ref":"#/components/schemas/ApiToken"}}},"description":"OK"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"error":{"example":"invalid_token","type":"string"},"error_description":{"example":"Invalid access token","type":"string"}},"type":"object","$$ref":"#/components/schemas/UnauthorizedError"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"description":"A URI reference that identifies the problem type. When this member is not present, its value is assumed to be \"about:blank\".","type":"string"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","type":"integer"},"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"}},"type":"object","$$ref":"#/components/schemas/Error"}}},"description":"Insufficient permissions to query endpoint"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"description":"A URI reference that identifies the problem type. When this member is not present, its value is assumed to be \"about:blank\".","type":"string"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","type":"integer"},"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"}},"type":"object","$$ref":"#/components/schemas/Error"}}},"description":"The user has reached the maximum number of allowed tokens."},"500":{"content":{"application/problem+json":{"example":{"type":"about:blank","title":"Internal server error","status":500,"detail":"Optional detail about the internal error message.","instance":"/v7"},"schema":{"properties":{"type":{"description":"A URI reference that identifies the problem type. When this member is not present, its value is assumed to be \"about:blank\".","type":"string"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","type":"integer"},"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"}},"type":"object","$$ref":"#/components/schemas/Error"}}},"description":"Internal server error"}},"summary":"Regenerate API token","tags":["API Token"],"__originalOperationId":"regenerateApiToken","security":[{"BearerAuth":[]}],"method":"post","path":"/api-tokens"}}