---
title: "Resolve Scoped IDs"
method: POST
path: "/v2/scoped-ids/resolve"
tags: ["Workflow API"]
---

# Resolve Scoped IDs

`POST /v2/scoped-ids/resolve`

Resolve team-scoped ids (wf_/skill_/ent_) to their resource UUID, display name, and kind within a team. Unresolvable ids are omitted.

## Request body

- SvflowPublicapiResolveScopedRefsRequest
  - `teamId` string — The team to resolve the scoped ids within.
  - `scopedIds` string[] — The scoped ids to resolve (wf_/skill_/ent_). Ids that do not resolve in the team are omitted from the response.

## Response `200`

Success

- SvflowPublicapiResolveScopedRefsResponse
  - `data` SvflowPublicapiResolvedScopedRef[] — The resolved references, one per scoped id that exists in the team.
    - `scopedId` string — The scoped id that was resolved.
    - `id` string — The resource's global UUID within the team.
    - `name` string — The resource's display name.
    - `kind` string — The resource kind: "workflow", "guidance", or "entitlement".

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)