Retrieve by path

1 curl -X POST https://api.humanloop.com/v5/files/retrieve-by-path \ 2 -H "X-API-KEY: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "path": "path" 6 }'

1 { 2 "path": "path", 3 "id": "id", 4 "directory_id": "directory_id", 5 "model": "model", 6 "endpoint": "complete", 7 "template": "template", 8 "template_language": "default", 9 "provider": "openai", 10 "max_tokens": 1, 11 "temperature": 1.1, 12 "top_p": 1.1, 13 "stop": "stop", 14 "presence_penalty": 1.1, 15 "frequency_penalty": 1.1, 16 "other": { 17 "key": "value" 18 }, 19 "seed": 1, 20 "response_format": { 21 "type": "json_object", 22 "json_schema": { 23 "key": "value" 24 } 25 }, 26 "reasoning_effort": "high", 27 "tools": [ 28 { 29 "name": "name", 30 "description": "description", 31 "strict": true, 32 "parameters": { 33 "key": "value" 34 } 35 } 36 ], 37 "linked_tools": [ 38 { 39 "name": "name", 40 "description": "description", 41 "strict": true, 42 "parameters": { 43 "key": "value" 44 }, 45 "id": "id", 46 "version_id": "version_id" 47 } 48 ], 49 "attributes": { 50 "key": "value" 51 }, 52 "version_name": "version_name", 53 "version_description": "version_description", 54 "description": "description", 55 "tags": [ 56 "tags" 57 ], 58 "readme": "readme", 59 "name": "name", 60 "version_id": "version_id", 61 "type": "prompt", 62 "environments": [ 63 { 64 "id": "id", 65 "created_at": "2024-01-15T09:30:00Z", 66 "name": "name", 67 "tag": "default" 68 } 69 ], 70 "created_at": "2024-01-15T09:30:00Z", 71 "updated_at": "2024-01-15T09:30:00Z", 72 "created_by": { 73 "id": "id", 74 "email_address": "email_address", 75 "full_name": "full_name" 76 }, 77 "last_used_at": "2024-01-15T09:30:00Z", 78 "version_logs_count": 1, 79 "total_logs_count": 1, 80 "inputs": [ 81 { 82 "name": "name" 83 } 84 ], 85 "evaluator_aggregates": [ 86 { 87 "value": 1.1, 88 "evaluator_id": "evaluator_id", 89 "evaluator_version_id": "evaluator_version_id", 90 "created_at": "2024-01-15T09:30:00Z", 91 "updated_at": "2024-01-15T09:30:00Z" 92 } 93 ] 94 }

Retrieve a File by path.

Query parameters

environmentstringOptional

Name of the Environment to retrieve a deployed Version from.

Request

This endpoint expects an object.

pathstringRequired

Path of the File to retrieve.

Response

Successful Response

Prompt Responseobject

Tool Responseobject

Dataset Responseobject

Evaluator Responseobject

Flow Responseobject

Headers

Query parameters

Request

Response

Errors