# Texture Categories ## GET /textures-categories/list #### Endpoint: Retrieve All Texture Categories **HTTP Method:** `GET` **URL:** `/open-api/v1/textures-categories/list` **Description:** This endpoint retrieves a list of all texture categories available in the database **without applying pagination filters**. It returns a detailed list ensuring all categories are accessible in a single response. **Response Format:** * **Status Code:** `200 OK` * **Content-Type:** `application/json` **Response Example:** ```json [ { "id": "1", "name": "Wood" }, { "id": "2", "name": "Metal" }, { "id": "3", "name": "Stone" } // ... more categories ] ``` **Notes:** * Ensure proper authorization headers are included if necessary. * The response will include all categories, so handle large datasets appropriately in your application. ## Retrieve all texture categories without pagination > Get all texture categories without pagination. ```json {"openapi":"3.0.0","info":{"title":"Simplio3D-Open REST API","version":"1.0.0"},"tags":[{"name":"Textures Categories","description":"API Endpoints for managing textures categories"}],"servers":[{"url":"https://app.simplio3d.com","description":"API Open Base URL"},{"url":""}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter token in format (Bearer )"}},"schemas":{"TexturesCategoriesResource":{"title":"Textures Categories Resource","description":"Textures category data","properties":{"id":{"type":"integer"},"title":{"type":"string"},"description":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"created_by":{"type":"string"}},"type":"object"}}},"paths":{"/api/open-api/v1/textures-categories/list":{"get":{"tags":["Textures Categories"],"summary":"Retrieve all texture categories without pagination","description":"Get all texture categories without pagination.","operationId":"fd9aac44d78db7d908bb05a8a968a93a","parameters":[{"name":"order_by","in":"query","description":"Column to order results by (e.g., 'created_at')","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","description":"Sorting order (asc or desc)","required":false,"schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TexturesCategoriesResource"}}}}},"401":{"description":"Unauthorized"},"500":{"description":"Internal server error"}}}}}} ``` ## GET /textures-categories/{id} #### Get Texture Category by ID - GET Endpoint **Endpoint:** ``` GET open-api/v1/textures-categories/{id} ``` **Description:** Retrieve detailed information about a specific texture category using its unique ID. **Authorization:** Ensure appropriate authorization headers are included in the request. **Parameters:** * **id** (path parameter) - The unique identifier of the texture category. **Response:** Returns a JSON object containing detailed information about the texture category, such as its name, description, and any related metadata. **Example Response:** ```json { "id": "2", "name": "Metal", "description": "A category for all metal-based textures." } ``` **Notes:** * Handle any potential errors such as `404 Not Found` for invalid IDs. * Consider rate limits and implement retry logic as appropriate. ## Get texture category by ID > Get a specific texture category by ID. ```json {"openapi":"3.0.0","info":{"title":"Simplio3D-Open REST API","version":"1.0.0"},"tags":[{"name":"Textures Categories","description":"API Endpoints for managing textures categories"}],"servers":[{"url":"https://app.simplio3d.com","description":"API Open Base URL"},{"url":""}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter token in format (Bearer )"}},"schemas":{"TexturesCategoriesResource":{"title":"Textures Categories Resource","description":"Textures category data","properties":{"id":{"type":"integer"},"title":{"type":"string"},"description":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"created_by":{"type":"string"}},"type":"object"}}},"paths":{"/api/open-api/v1/textures-categories/{id}":{"get":{"tags":["Textures Categories"],"summary":"Get texture category by ID","description":"Get a specific texture category by ID.","operationId":"8b5635edf89f4fc6e0a4d81bc7c11c29","parameters":[{"name":"id","in":"path","description":"ID of the texture category","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TexturesCategoriesResource"}}}},"401":{"description":"Unauthorized"},"404":{"description":"Texture category not found"}}}}}} ``` ## GET /textures-categories #### Get List of Texture Categories The **Get List of Texture Categories** endpoint retrieves a complete list of available texture categories. Each category includes essential details such as the category's ID, name, and description. **Endpoint** ``` GET /open-api/v1/textures-categories ``` **Example Request** ```http GET /open-api/v1/texture-categories HTTP/1.1 Host: api.simplio3d.com Authorization: Bearer YOUR_ACCESS_TOKEN ``` **Example Response** ```json [ { "id": "1", "name": "Wood", "description": "A category for all wood-based textures." }, { "id": "2", "name": "Metal", "description": "A category for all metal-based textures." } ] ``` **Notes** * Ensure a valid access token is provided in the request header. * Handle potential errors, such as `401 Unauthorized` if the token is invalid or expired. * Implement retry logic to handle rate limit errors if encountered. ## Get list of textures categories > Get all textures categories. ```json {"openapi":"3.0.0","info":{"title":"Simplio3D-Open REST API","version":"1.0.0"},"tags":[{"name":"Textures Categories","description":"API Endpoints for managing textures categories"}],"servers":[{"url":"https://app.simplio3d.com","description":"API Open Base URL"},{"url":""}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter token in format (Bearer )"}}},"paths":{"/api/open-api/v1/textures-categories":{"get":{"tags":["Textures Categories"],"summary":"Get list of textures categories","description":"Get all textures categories.","operationId":"17c8efb40642d28b9ed1f52bf7978bca","parameters":[{"name":"per_page","in":"query","description":"Number of records per page (-1 for all records)","schema":{"type":"integer"}},{"name":"page","in":"query","description":"Number of page","required":false,"schema":{"type":"integer"}},{"name":"order_by","in":"query","description":"Column to sort by","schema":{"type":"string"}},{"name":"order","in":"query","description":"Sort order (asc/desc)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}}}}}} ``` --- # 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.simplio3d.com/api-reference/open-api/textures/texture-categories.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.