Skip to main content
GET
Returns the Target identified by id in the authenticated organization’s scope. Reading a Target also promotes any proposed members if auto_admit is already true; it does not start a new discovery job.

Request

string
required
Target UUID. The route does not declare a separate path-schema format, but the stored ID is a UUID.
No query parameters or body.

Response

200 OK returns { "data": Target }. The Target schema is: job.status reflects the latest associated ingest job, commonly pending, running, done, or failed. There is no Target-level status property in this response.

Examples

Errors and recovery

  • 401 unauthorized, 402 payment_required, and platform-key 400 invalid_request have the shared authentication/access meanings.
  • 404 not_found with {"error":{"type":"not_found","message":"watch not found"}} means the ID is absent from this organization. Do not retry unchanged.
  • 429 and 5xx: retry this read with bounded backoff and honor Retry-After.

Lifecycle and side effects

This is a read, but it calls the service’s auto-admit reconciliation. If the Target has auto_admit: true, proposed members are moved to watching and the default lists are synchronized. That transition is not a completion guarantee for enrichment or Monitoring. The route then loads the latest job and attaches graph allocation counts.

Next