List Parts
Lists a collection of parts.
All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN> as a header to every API request.
How do I find my token?
In: header
Query Parameters
Filters for parts created by any of these users.
The cursor to resume iteration from. If not provided, then iteration starts from the beginning.
textThe maximum number of parts to return. The default is '50'.
int32The iteration mode to use, otherwise if not set, then "after" is used.
"after" | "before"Filters for parts modified by any of these users.
Filters for parts of the provided name(s).
Filters for parts owned by any of these users.
Number of levels to fetch the part hierarchy up to.
int321 <= valuePart IDs to fetch the hierarchy for. Required if any parent_part.* fields are provided.
1 <= itemsFields to sort the parts by and the direction to sort them.
Filters for part with any of the provided tags.
Filters for parts of the provided type(s).
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.devrev.ai/parts.list?created_by=DEVU-12345&cursor=string&limit=0&mode=after&modified_by=DEVU-12345&name=string&owned_by=DEVU-12345&parent_part.level=1&parent_part.parts=PROD-12345&sort_by=string&tags=TAG-12345&type=capability"{
"next_cursor": "string",
"parts": [
{
"type": "capability",
"created_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"created_date": "2023-01-01T12:00:00.000Z",
"display_id": "string",
"id": "string",
"modified_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"modified_date": "2023-01-01T12:00:00.000Z",
"artifacts": [
{
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
}
],
"description": "string",
"name": "string",
"owned_by": [
{
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
}
],
"tags": [
{
"tag": {
"display_id": "string",
"id": "string",
"name": "string"
},
"value": "string"
}
]
}
],
"prev_cursor": "string"
}{
"detail": "string",
"message": "string",
"type": "artifact_already_attached_to_a_parent",
"existing_parent": "string",
"is_same": true
}{
"detail": "string",
"message": "string",
"type": "unauthenticated"
}{
"detail": "string",
"message": "string",
"type": "forbidden"
}{
"detail": "string",
"message": "string",
"type": "too_many_requests",
"retry_after": 0
}{
"detail": "string",
"message": "string",
"type": "internal_error",
"reference_id": "string"
}{
"detail": "string",
"message": "string",
"type": "service_unavailable"
}