{"openapi":"3.1.0","info":{"title":"New Relic Entities (BYOK) API","version":"0.1.0","description":"New Relic Entities (BYOK) lets an AI assistant read your own New Relic Entities data through the New Relic Entities API with a key you supply (New Relic user API key (US data center)). Read-only: 7 tools (get_entity, get_entity_tags, get_entity_golden_metrics, get_entity_golden_tags, get_entity_relationships, get_entity_recent_violations, get_entity_service_levels). The BYOK key travels with each...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-newrelic-entities.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-newrelic-entities/docs"},"termsOfService":"https://connectorbay.com/byok-newrelic-entities/terms"},"servers":[{"url":"https://byok-newrelic-entities.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-newrelic-entities/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_entity":{"post":{"operationId":"get_entity","summary":"Get an entity by GUID: name, type, domain, owning account, alert severity, whether it is reporting, last reporting chang","description":"Get an entity by GUID: name, type, domain, owning account, alert severity, whether it is reporting, last reporting change, first and last indexed time and permalink. Use for \"What is the status of New Relic entity MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"guid":{"description":"Entity GUID, a long base64-style id such as 'MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ'. Find it with the New Relic connector's search_entities tool.","maxLength":300,"title":"Guid","type":"string"}},"required":["guid"],"title":"get_entityArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_entity_tags":{"post":{"operationId":"get_entity_tags","summary":"List the tags of an entity (key and values), such as environment, language or cloud region. Use for \"Which tags does New","description":"List the tags of an entity (key and values), such as environment, language or cloud region. Use for \"Which tags does New Relic entity MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"guid":{"description":"Entity GUID, a long base64-style id such as 'MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ'. Find it with the New Relic connector's search_entities tool.","maxLength":300,"title":"Guid","type":"string"}},"required":["guid"],"title":"get_entity_tagsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_entity_golden_metrics":{"post":{"operationId":"get_entity_golden_metrics","summary":"List the entity's golden metrics: title, name and the NRQL query behind each (the key health indicators New Relic shows ","description":"List the entity's golden metrics: title, name and the NRQL query behind each (the key health indicators New Relic shows for it). Use for \"What are the golden metrics of New Relic entity MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"guid":{"description":"Entity GUID, a long base64-style id such as 'MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ'. Find it with the New Relic connector's search_entities tool.","maxLength":300,"title":"Guid","type":"string"}},"required":["guid"],"title":"get_entity_golden_metricsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_entity_golden_tags":{"post":{"operationId":"get_entity_golden_tags","summary":"List the golden tag keys of an entity (the tags New Relic highlights for it). Use for \"Which golden tags does New Relic ","description":"List the golden tag keys of an entity (the tags New Relic highlights for it). Use for \"Which golden tags does New Relic entity MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"guid":{"description":"Entity GUID, a long base64-style id such as 'MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ'. Find it with the New Relic connector's search_entities tool.","maxLength":300,"title":"Guid","type":"string"}},"required":["guid"],"title":"get_entity_golden_tagsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_entity_relationships":{"post":{"operationId":"get_entity_relationships","summary":"List entities related to this one (calls, hosts, containers, dependencies): relationship type plus source and target ent","description":"List entities related to this one (calls, hosts, containers, dependencies): relationship type plus source and target entity guid and name. First page only. Use for \"What does New Relic entity MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ depend on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"guid":{"description":"Entity GUID, a long base64-style id such as 'MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ'. Find it with the New Relic connector's search_entities tool.","maxLength":300,"title":"Guid","type":"string"}},"required":["guid"],"title":"get_entity_relationshipsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_entity_recent_violations":{"post":{"operationId":"get_entity_recent_violations","summary":"List recent alert violations of an entity: label, level, open and close time, severity and violation URL. Use for \"Has N","description":"List recent alert violations of an entity: label, level, open and close time, severity and violation URL. Use for \"Has New Relic entity MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ had alert violations recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"guid":{"description":"Entity GUID, a long base64-style id such as 'MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ'. Find it with the New Relic connector's search_entities tool.","maxLength":300,"title":"Guid","type":"string"}},"required":["guid"],"title":"get_entity_recent_violationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_entity_service_levels":{"post":{"operationId":"get_entity_service_levels","summary":"List service level indicators of an entity with name, description and objective targets over rolling time windows. Creat","description":"List service level indicators of an entity with name, description and objective targets over rolling time windows. Creator details are left out. Use for \"Which service level objectives does New Relic entity MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"guid":{"description":"Entity GUID, a long base64-style id such as 'MTIzNDU2N3xBUE18QVBQTElDQVRJT058MQ'. Find it with the New Relic connector's search_entities tool.","maxLength":300,"title":"Guid","type":"string"}},"required":["guid"],"title":"get_entity_service_levelsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}