# FileSets ## List File Sets > List all FileSets for the organization, optionally including public filesets. ```json {"openapi":"3.1.0","info":{"title":"LightningRod API","version":"1.0.0"},"servers":[{"url":"/api/public/v1"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"ListFileSetsResponse":{"properties":{"file_sets":{"items":{"$ref":"#/components/schemas/FileSet"},"type":"array","title":"File Sets"}},"type":"object","required":["file_sets"],"title":"ListFileSetsResponse"},"FileSet":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"file_count":{"type":"integer","title":"File Count"},"indexed_file_count":{"type":"integer","title":"Indexed File Count"},"metadata_schema":{"anyOf":[{"$ref":"#/components/schemas/FileSetMetadataSchema"},{"type":"null"}]},"is_public":{"type":"boolean","title":"Is Public","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","description","file_count","indexed_file_count","created_at","updated_at"],"title":"FileSet"},"FileSetMetadataSchema":{"properties":{"fields":{"items":{"$ref":"#/components/schemas/MetadataFieldDefinition"},"type":"array","title":"Fields","description":"List of metadata field definitions"}},"type":"object","title":"FileSetMetadataSchema","description":"Schema definition for file metadata in a FileSet."},"MetadataFieldDefinition":{"properties":{"name":{"type":"string","title":"Name","description":"The name/key of the metadata field"},"field_type":{"$ref":"#/components/schemas/MetadataFieldType","description":"The data type of the field. Boolean-like values should use \"string\" with canonical \"true\"/\"false\" values."},"required":{"type":"boolean","title":"Required","description":"Whether this field is required for all files","default":false},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Human-readable description of this field"},"extraction_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Hint","description":"Hint for LLM auto-extraction (e.g., 'the stock ticker symbol mentioned')"}},"type":"object","required":["name","field_type"],"title":"MetadataFieldDefinition","description":"Definition of a metadata field for a FileSet."},"MetadataFieldType":{"type":"string","enum":["string","number"],"title":"MetadataFieldType"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/filesets/":{"get":{"tags":["FileSets"],"summary":"List File Sets","description":"List all FileSets for the organization, optionally including public filesets.","operationId":"list_file_sets_filesets__get","parameters":[{"name":"include_public","in":"query","required":false,"schema":{"type":"boolean","description":"Include public filesets","default":false,"title":"Include Public"},"description":"Include public filesets"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFileSetsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}} ``` ## Create File Set > Create a new FileSet for the organization. ```json {"openapi":"3.1.0","info":{"title":"LightningRod API","version":"1.0.0"},"servers":[{"url":"/api/public/v1"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"CreateFileSetRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Human-readable name for the FileSet"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Optional description of the FileSet's purpose"},"metadata_schema":{"anyOf":[{"$ref":"#/components/schemas/FileSetMetadataSchemaInput"},{"type":"null"}],"description":"Optional schema for validating file metadata"}},"type":"object","required":["name"],"title":"CreateFileSetRequest"},"FileSetMetadataSchemaInput":{"properties":{"fields":{"items":{"$ref":"#/components/schemas/MetadataFieldDefinitionInput"},"type":"array","title":"Fields","description":"List of metadata field definitions"}},"type":"object","required":["fields"],"title":"FileSetMetadataSchemaInput","description":"Schema definition for file metadata in a FileSet (input/request version)."},"MetadataFieldDefinitionInput":{"properties":{"name":{"type":"string","title":"Name","description":"The name/key of the metadata field"},"field_type":{"$ref":"#/components/schemas/MetadataFieldType","description":"The data type of the field. Boolean-like values should use \"string\" with canonical \"true\"/\"false\" values."},"required":{"type":"boolean","title":"Required","description":"Whether this field is required for all files"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Human-readable description of this field"},"extraction_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Hint","description":"Hint for LLM auto-extraction (e.g., 'the stock ticker symbol mentioned')"}},"type":"object","required":["name","field_type","required"],"title":"MetadataFieldDefinitionInput","description":"Definition of a metadata field for a FileSet (input/request version)."},"MetadataFieldType":{"type":"string","enum":["string","number"],"title":"MetadataFieldType"},"FileSet":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"file_count":{"type":"integer","title":"File Count"},"indexed_file_count":{"type":"integer","title":"Indexed File Count"},"metadata_schema":{"anyOf":[{"$ref":"#/components/schemas/FileSetMetadataSchema"},{"type":"null"}]},"is_public":{"type":"boolean","title":"Is Public","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","description","file_count","indexed_file_count","created_at","updated_at"],"title":"FileSet"},"FileSetMetadataSchema":{"properties":{"fields":{"items":{"$ref":"#/components/schemas/MetadataFieldDefinition"},"type":"array","title":"Fields","description":"List of metadata field definitions"}},"type":"object","title":"FileSetMetadataSchema","description":"Schema definition for file metadata in a FileSet."},"MetadataFieldDefinition":{"properties":{"name":{"type":"string","title":"Name","description":"The name/key of the metadata field"},"field_type":{"$ref":"#/components/schemas/MetadataFieldType","description":"The data type of the field. Boolean-like values should use \"string\" with canonical \"true\"/\"false\" values."},"required":{"type":"boolean","title":"Required","description":"Whether this field is required for all files","default":false},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Human-readable description of this field"},"extraction_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Hint","description":"Hint for LLM auto-extraction (e.g., 'the stock ticker symbol mentioned')"}},"type":"object","required":["name","field_type"],"title":"MetadataFieldDefinition","description":"Definition of a metadata field for a FileSet."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/filesets/":{"post":{"tags":["FileSets"],"summary":"Create File Set","description":"Create a new FileSet for the organization.","operationId":"create_file_set_filesets__post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFileSetRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileSet"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}} ``` ## Get File Set > Get a specific FileSet by ID. ```json {"openapi":"3.1.0","info":{"title":"LightningRod API","version":"1.0.0"},"servers":[{"url":"/api/public/v1"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"FileSet":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"file_count":{"type":"integer","title":"File Count"},"indexed_file_count":{"type":"integer","title":"Indexed File Count"},"metadata_schema":{"anyOf":[{"$ref":"#/components/schemas/FileSetMetadataSchema"},{"type":"null"}]},"is_public":{"type":"boolean","title":"Is Public","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","description","file_count","indexed_file_count","created_at","updated_at"],"title":"FileSet"},"FileSetMetadataSchema":{"properties":{"fields":{"items":{"$ref":"#/components/schemas/MetadataFieldDefinition"},"type":"array","title":"Fields","description":"List of metadata field definitions"}},"type":"object","title":"FileSetMetadataSchema","description":"Schema definition for file metadata in a FileSet."},"MetadataFieldDefinition":{"properties":{"name":{"type":"string","title":"Name","description":"The name/key of the metadata field"},"field_type":{"$ref":"#/components/schemas/MetadataFieldType","description":"The data type of the field. Boolean-like values should use \"string\" with canonical \"true\"/\"false\" values."},"required":{"type":"boolean","title":"Required","description":"Whether this field is required for all files","default":false},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Human-readable description of this field"},"extraction_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Hint","description":"Hint for LLM auto-extraction (e.g., 'the stock ticker symbol mentioned')"}},"type":"object","required":["name","field_type"],"title":"MetadataFieldDefinition","description":"Definition of a metadata field for a FileSet."},"MetadataFieldType":{"type":"string","enum":["string","number"],"title":"MetadataFieldType"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/filesets/{file_set_id}":{"get":{"tags":["FileSets"],"summary":"Get File Set","description":"Get a specific FileSet by ID.","operationId":"get_file_set_filesets__file_set_id__get","parameters":[{"name":"file_set_id","in":"path","required":true,"schema":{"type":"string","title":"File Set Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileSet"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}} ``` ## List Files In Set > List all files in a FileSet. ```json {"openapi":"3.1.0","info":{"title":"LightningRod API","version":"1.0.0"},"servers":[{"url":"/api/public/v1"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"ListFileSetFilesResponse":{"properties":{"files":{"items":{"$ref":"#/components/schemas/FileSetFile"},"type":"array","title":"Files"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["files","has_more","total"],"title":"ListFileSetFilesResponse"},"FileSetFile":{"properties":{"id":{"type":"string","title":"Id"},"original_file_name":{"type":"string","title":"Original File Name"},"cloud_storage_path":{"type":"string","title":"Cloud Storage Path"},"mime_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime Type"},"size_bytes":{"type":"integer","title":"Size Bytes"},"character_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Character Count"},"metadata":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]},"type":"object"},{"type":"null"}],"title":"Metadata"},"gemini_file_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gemini File Id"},"file_created_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"File Created Date"},"status":{"$ref":"#/components/schemas/FileSetFileStatus","default":"PENDING"},"status_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Message"},"retry_count":{"type":"integer","title":"Retry Count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","original_file_name","cloud_storage_path","mime_type","size_bytes","character_count","metadata","gemini_file_id","file_created_date","created_at","updated_at"],"title":"FileSetFile"},"FileSetFileStatus":{"type":"string","enum":["PENDING","PROCESSING","ACTIVE","FAILED"],"title":"FileSetFileStatus"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/filesets/{file_set_id}/files":{"get":{"tags":["FileSets"],"summary":"List Files In Set","description":"List all files in a FileSet.","operationId":"list_files_in_set_filesets__file_set_id__files_get","parameters":[{"name":"file_set_id","in":"path","required":true,"schema":{"type":"string","title":"File Set Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFileSetFilesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}} ``` ## Add File To Set > Add a file to a FileSet by providing file information and metadata. ```json {"openapi":"3.1.0","info":{"title":"LightningRod API","version":"1.0.0"},"servers":[{"url":"/api/public/v1"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"CreateFileSetFileRequest":{"properties":{"file_id":{"type":"string","title":"File Id","description":"ID of the file"},"file_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"File Date","description":"The date of the document content. Critical for forward-looking question generation pipelines - this date determines the temporal context for forecasting questions."},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Optional file-level metadata"},"deduplication_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deduplication Id","description":"Optional id used to deduplicate file additions to a FileSet"},"auto_extract_metadata":{"type":"boolean","title":"Auto Extract Metadata","description":"If true and the FileSet has a metadata schema, automatically extract metadata from file content using LLM. User-provided metadata takes precedence over extracted values.","default":false}},"type":"object","required":["file_id"],"title":"CreateFileSetFileRequest"},"FileSetFile":{"properties":{"id":{"type":"string","title":"Id"},"original_file_name":{"type":"string","title":"Original File Name"},"cloud_storage_path":{"type":"string","title":"Cloud Storage Path"},"mime_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime Type"},"size_bytes":{"type":"integer","title":"Size Bytes"},"character_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Character Count"},"metadata":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"}]},"type":"object"},{"type":"null"}],"title":"Metadata"},"gemini_file_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gemini File Id"},"file_created_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"File Created Date"},"status":{"$ref":"#/components/schemas/FileSetFileStatus","default":"PENDING"},"status_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Message"},"retry_count":{"type":"integer","title":"Retry Count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","original_file_name","cloud_storage_path","mime_type","size_bytes","character_count","metadata","gemini_file_id","file_created_date","created_at","updated_at"],"title":"FileSetFile"},"FileSetFileStatus":{"type":"string","enum":["PENDING","PROCESSING","ACTIVE","FAILED"],"title":"FileSetFileStatus"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/filesets/{file_set_id}/files":{"post":{"tags":["FileSets"],"summary":"Add File To Set","description":"Add a file to a FileSet by providing file information and metadata.","operationId":"add_file_to_set_filesets__file_set_id__files_post","parameters":[{"name":"file_set_id","in":"path","required":true,"schema":{"type":"string","title":"File Set Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFileSetFileRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileSetFile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}} ``` ## Get File Set Status > Get file status counts for a FileSet. ```json {"openapi":"3.1.0","info":{"title":"LightningRod API","version":"1.0.0"},"servers":[{"url":"/api/public/v1"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"FileStatusCountsResponse":{"properties":{"pending":{"type":"integer","title":"Pending","description":"Files awaiting processing","default":0},"processing":{"type":"integer","title":"Processing","description":"Files currently being processed","default":0},"active":{"type":"integer","title":"Active","description":"Successfully processed files","default":0},"failed":{"type":"integer","title":"Failed","description":"Files that failed processing","default":0}},"type":"object","title":"FileStatusCountsResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/filesets/{file_set_id}/status":{"get":{"tags":["FileSets"],"summary":"Get File Set Status","description":"Get file status counts for a FileSet.","operationId":"get_file_set_status_filesets__file_set_id__status_get","parameters":[{"name":"file_set_id","in":"path","required":true,"schema":{"type":"string","title":"File Set Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileStatusCountsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}} ``` ## Retry Failed Files > Retry all failed files in a FileSet. ```json {"openapi":"3.1.0","info":{"title":"LightningRod API","version":"1.0.0"},"servers":[{"url":"/api/public/v1"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"RetryFailedFilesRequest":{"properties":{"max_retries":{"type":"integer","maximum":10,"minimum":1,"title":"Max Retries","description":"Maximum retry attempts per file","default":3}},"type":"object","title":"RetryFailedFilesRequest"},"RetryFailedFilesResponse":{"properties":{"files_reset":{"type":"integer","title":"Files Reset","description":"Number of files reset to PENDING status"}},"type":"object","required":["files_reset"],"title":"RetryFailedFilesResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/filesets/{file_set_id}/retry-failed":{"post":{"tags":["FileSets"],"summary":"Retry Failed Files","description":"Retry all failed files in a FileSet.","operationId":"retry_failed_files_filesets__file_set_id__retry_failed_post","parameters":[{"name":"file_set_id","in":"path","required":true,"schema":{"type":"string","title":"File Set Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetryFailedFilesRequest","default":{"max_retries":3}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetryFailedFilesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.lightningrod.ai/rest-api/filesets.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.