usage
POST/v1/tools/usage
Report the calling organization's plan, the free quota it has left this period and the day the quota renews, its balance, the credits its agents' tasks hold and what is left available to spend, the coverage it has left for the current period, the per-call limits in force, how many projects it holds revealed and how many profile parts it currently holds. Free. Consult it before planning a wide search: coverage limits how many new entities you can see in a period; the free quota and the available credits (the balance less what agents' tasks hold) limit what you can pay for. What the tools accept and charge for is in capabilities.
Request
Responses
- 200
- 400
- 401
- 413
- 415
- 429
- 500
- 503
The tool's answer
Response Headers
The request's id: quote it when you write to Megido support
The request cannot be served as sent: bad_request, invalid_params
Response Headers
The request's id: quote it when you write to Megido support
No key, or a key the API does not take: unauthorised
Response Headers
The request's id: quote it when you write to Megido support
Bearer realm="megido": send an API key of your organization as a Bearer token
The body is larger than the API takes: bad_request
Response Headers
The request's id: quote it when you write to Megido support
The body is not sent as application/json: bad_request
Response Headers
The request's id: quote it when you write to Megido support
Too many calls: rate_limited
Response Headers
The request's id: quote it when you write to Megido support
Seconds to wait before calling again; sent with rate_limited and lock_timeout only
The call failed on Megido's side: internal_error
Response Headers
The request's id: quote it when you write to Megido support
Not available just now: service_unavailable, lock_timeout
Response Headers
The request's id: quote it when you write to Megido support
Seconds to wait before calling again; sent with rate_limited and lock_timeout only