Gets a specific action type with the given API name.
Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:ontologies-read.
stringThe API name or RID of the Ontology. To find the API name or RID, use the List Ontologies endpoint or check the Ontology Manager.
stringThe name of the action type in the API.
stringThe Foundry branch to load the action type definition from. If not specified, the default branch will be used. Branches are an experimental feature and not all workflows are supported.
objectSuccess response.
stringThe name of the action type in the API. To find the API name for your Action Type, use the List action types
endpoint or check the Ontology Manager.
stringstringThe display name of the entity.
string (enum)The release status of the entity.
Enum values: ACTIVE, ENDORSED, EXPERIMENTAL, DEPRECATED
map<ParameterId, ActionParameterV2>stringThe unique resource identifier of an action type, useful for interacting with other Foundry APIs.
list<LogicRule>1
2
3
curl \
\t-H "Authorization: Bearer $TOKEN" \
	"https://$HOSTNAME/api/v2/ontologies/palantir/actionTypes/promote-employee?branch=ri.branch..branch.d827184f-ee0e-4351-8b70-efbe51e07252"1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "data": {
    "apiName": "promote-employee",
    "description": "Update an employee's title and compensation",
    "parameters": {
      "employeeId": {
        "dataType": {
          "type": "integer"
        }
      },
      "newTitle": {
        "dataType": {
          "type": "string"
        }
      },
      "newCompensation": {
        "dataType": {
          "type": "double"
        }
      }
    },
    "rid": "ri.ontology.main.action-type.7ed72754-7491-428a-bb18-4d7296eb2167"
  }
}