# GENERADO — NO EDITAR A MANO # Fuente: app FastAPI (`api.main.create_app`). Regenerar con: # python -m api.openapi_export # Contrato: docs/16-contrato-canonico.md §3-§4 · reglas: openapi/README.md components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object info: title: fleetManage API version: 0.1.0 openapi: 3.1.0 paths: /health: get: operationId: health_health_get responses: '200': content: application/json: schema: {} description: Successful Response summary: Healthcheck público tags: - health x-fleetbase-source: docs/09 §2.1.1 /int/v1/categories: get: operationId: listar_int_v1_categories_get parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization - description: Búsqueda de texto sobre los campos declarados. in: query name: query required: false schema: type: string - in: query name: limit required: false schema: default: 25 maximum: 100 minimum: 1 type: integer - in: query name: offset required: false schema: default: 0 minimum: 0 type: integer - description: Campos separados por coma; prefijo `-` para descendente. in: query name: sort required: false schema: type: string - description: 'Relaciones declaradas: parent' in: query name: with required: false schema: type: string - description: Filtro por igualdad de `core_category`. in: query name: where[core_category] required: false schema: type: string - description: Rango >= de `core_category`. in: query name: core_category_gte required: false schema: type: string - description: Rango <= de `core_category`. in: query name: core_category_lte required: false schema: type: string - description: Filtro por igualdad de `for_`. in: query name: where[for_] required: false schema: type: string - description: Rango >= de `for_`. in: query name: for__gte required: false schema: type: string - description: Rango <= de `for_`. in: query name: for__lte required: false schema: type: string - description: Filtro por igualdad de `name`. in: query name: where[name] required: false schema: type: string - description: Rango >= de `name`. in: query name: name_gte required: false schema: type: string - description: Rango <= de `name`. in: query name: name_lte required: false schema: type: string - description: Filtro por igualdad de `order`. in: query name: where[order] required: false schema: type: string - description: Rango >= de `order`. in: query name: order_gte required: false schema: type: string - description: Rango <= de `order`. in: query name: order_lte required: false schema: type: string - description: Filtro por igualdad de `parent_uuid`. in: query name: where[parent_uuid] required: false schema: type: string - description: Rango >= de `parent_uuid`. in: query name: parent_uuid_gte required: false schema: type: string - description: Rango <= de `parent_uuid`. in: query name: parent_uuid_lte required: false schema: type: string - description: Filtro por igualdad de `slug`. in: query name: where[slug] required: false schema: type: string - description: Rango >= de `slug`. in: query name: slug_gte required: false schema: type: string - description: Rango <= de `slug`. in: query name: slug_lte required: false schema: type: string responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Listar categories tags: - int/v1 - categories x-fleetbase-source: docs/09 §1 post: operationId: crear_int_v1_categories_post parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '201': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Crear categories tags: - int/v1 - categories x-fleetbase-source: docs/09 §1 /int/v1/categories/bulk-delete: delete: operationId: borrado_masivo_int_v1_categories_bulk_delete_delete parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization requestBody: content: application/json: schema: oneOf: - items: type: string type: array - properties: ids: items: type: string type: array required: - ids type: object required: true responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Borrado masivo de categories tags: - int/v1 - categories x-fleetbase-source: docs/09 §1 /int/v1/categories/{id}: delete: operationId: borrar_int_v1_categories__id__delete parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '204': description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error summary: Borrar categories (soft-delete) tags: - int/v1 - categories x-fleetbase-source: docs/09 §1 get: operationId: detalle_int_v1_categories__id__get parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Detalle de categories tags: - int/v1 - categories x-fleetbase-source: docs/09 §1 patch: operationId: editar_patch_int_v1_categories__id__patch parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar categories (PATCH) tags: - int/v1 - categories x-fleetbase-source: docs/09 §1 put: operationId: editar_put_int_v1_categories__id__put parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar categories (PUT) tags: - int/v1 - categories x-fleetbase-source: docs/09 §1 /int/v1/groups: get: operationId: listar_int_v1_groups_get parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization - description: Búsqueda de texto sobre los campos declarados. in: query name: query required: false schema: type: string - in: query name: limit required: false schema: default: 25 maximum: 100 minimum: 1 type: integer - in: query name: offset required: false schema: default: 0 minimum: 0 type: integer - description: Campos separados por coma; prefijo `-` para descendente. in: query name: sort required: false schema: type: string - description: 'Relaciones declaradas: ninguna' in: query name: with required: false schema: type: string - description: Filtro por igualdad de `created_at`. in: query name: where[created_at] required: false schema: type: string - description: Rango >= de `created_at`. in: query name: created_at_gte required: false schema: type: string - description: Rango <= de `created_at`. in: query name: created_at_lte required: false schema: type: string - description: Filtro por igualdad de `name`. in: query name: where[name] required: false schema: type: string - description: Rango >= de `name`. in: query name: name_gte required: false schema: type: string - description: Rango <= de `name`. in: query name: name_lte required: false schema: type: string - description: Filtro por igualdad de `slug`. in: query name: where[slug] required: false schema: type: string - description: Rango >= de `slug`. in: query name: slug_gte required: false schema: type: string - description: Rango <= de `slug`. in: query name: slug_lte required: false schema: type: string responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Listar groups tags: - int/v1 - groups x-fleetbase-source: docs/09 §1 post: operationId: crear_int_v1_groups_post parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '201': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Crear groups tags: - int/v1 - groups x-fleetbase-source: docs/09 §1 /int/v1/groups/bulk-delete: delete: operationId: borrado_masivo_int_v1_groups_bulk_delete_delete parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization requestBody: content: application/json: schema: oneOf: - items: type: string type: array - properties: ids: items: type: string type: array required: - ids type: object required: true responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Borrado masivo de groups tags: - int/v1 - groups x-fleetbase-source: docs/09 §1 /int/v1/groups/{id}: delete: operationId: borrar_int_v1_groups__id__delete parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '204': description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error summary: Borrar groups (soft-delete) tags: - int/v1 - groups x-fleetbase-source: docs/09 §1 get: operationId: detalle_int_v1_groups__id__get parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Detalle de groups tags: - int/v1 - groups x-fleetbase-source: docs/09 §1 patch: operationId: editar_patch_int_v1_groups__id__patch parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar groups (PATCH) tags: - int/v1 - groups x-fleetbase-source: docs/09 §1 put: operationId: editar_put_int_v1_groups__id__put parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar groups (PUT) tags: - int/v1 - groups x-fleetbase-source: docs/09 §1 /int/v1/places: get: operationId: listar_int_v1_places_get parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization - description: Búsqueda de texto sobre los campos declarados. in: query name: query required: false schema: type: string - in: query name: limit required: false schema: default: 25 maximum: 100 minimum: 1 type: integer - in: query name: offset required: false schema: default: 0 minimum: 0 type: integer - description: Campos separados por coma; prefijo `-` para descendente. in: query name: sort required: false schema: type: string - description: 'Relaciones declaradas: ninguna' in: query name: with required: false schema: type: string - description: Filtro por igualdad de `city`. in: query name: where[city] required: false schema: type: string - description: Rango >= de `city`. in: query name: city_gte required: false schema: type: string - description: Rango <= de `city`. in: query name: city_lte required: false schema: type: string - description: Filtro por igualdad de `country`. in: query name: where[country] required: false schema: type: string - description: Rango >= de `country`. in: query name: country_gte required: false schema: type: string - description: Rango <= de `country`. in: query name: country_lte required: false schema: type: string - description: Filtro por igualdad de `name`. in: query name: where[name] required: false schema: type: string - description: Rango >= de `name`. in: query name: name_gte required: false schema: type: string - description: Rango <= de `name`. in: query name: name_lte required: false schema: type: string - description: Filtro por igualdad de `owner_uuid`. in: query name: where[owner_uuid] required: false schema: type: string - description: Rango >= de `owner_uuid`. in: query name: owner_uuid_gte required: false schema: type: string - description: Rango <= de `owner_uuid`. in: query name: owner_uuid_lte required: false schema: type: string - description: Filtro por igualdad de `type`. in: query name: where[type] required: false schema: type: string - description: Rango >= de `type`. in: query name: type_gte required: false schema: type: string - description: Rango <= de `type`. in: query name: type_lte required: false schema: type: string responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Listar places tags: - int/v1 - places x-fleetbase-source: docs/09 §1 post: operationId: crear_int_v1_places_post parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '201': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Crear places tags: - int/v1 - places x-fleetbase-source: docs/09 §1 /int/v1/places/bulk-delete: delete: operationId: borrado_masivo_int_v1_places_bulk_delete_delete parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization requestBody: content: application/json: schema: oneOf: - items: type: string type: array - properties: ids: items: type: string type: array required: - ids type: object required: true responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Borrado masivo de places tags: - int/v1 - places x-fleetbase-source: docs/09 §1 /int/v1/places/{id}: delete: operationId: borrar_int_v1_places__id__delete parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '204': description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error summary: Borrar places (soft-delete) tags: - int/v1 - places x-fleetbase-source: docs/09 §1 get: operationId: detalle_int_v1_places__id__get parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Detalle de places tags: - int/v1 - places x-fleetbase-source: docs/09 §1 patch: operationId: editar_patch_int_v1_places__id__patch parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar places (PATCH) tags: - int/v1 - places x-fleetbase-source: docs/09 §1 put: operationId: editar_put_int_v1_places__id__put parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar places (PUT) tags: - int/v1 - places x-fleetbase-source: docs/09 §1 /v1/categories: get: operationId: listar_v1_categories_get parameters: - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret - description: Búsqueda de texto sobre los campos declarados. in: query name: query required: false schema: type: string - in: query name: limit required: false schema: default: 25 maximum: 100 minimum: 1 type: integer - in: query name: offset required: false schema: default: 0 minimum: 0 type: integer - description: Campos separados por coma; prefijo `-` para descendente. in: query name: sort required: false schema: type: string - description: 'Relaciones declaradas: parent' in: query name: with required: false schema: type: string - description: Filtro por igualdad de `core_category`. in: query name: where[core_category] required: false schema: type: string - description: Rango >= de `core_category`. in: query name: core_category_gte required: false schema: type: string - description: Rango <= de `core_category`. in: query name: core_category_lte required: false schema: type: string - description: Filtro por igualdad de `for_`. in: query name: where[for_] required: false schema: type: string - description: Rango >= de `for_`. in: query name: for__gte required: false schema: type: string - description: Rango <= de `for_`. in: query name: for__lte required: false schema: type: string - description: Filtro por igualdad de `name`. in: query name: where[name] required: false schema: type: string - description: Rango >= de `name`. in: query name: name_gte required: false schema: type: string - description: Rango <= de `name`. in: query name: name_lte required: false schema: type: string - description: Filtro por igualdad de `order`. in: query name: where[order] required: false schema: type: string - description: Rango >= de `order`. in: query name: order_gte required: false schema: type: string - description: Rango <= de `order`. in: query name: order_lte required: false schema: type: string - description: Filtro por igualdad de `parent_uuid`. in: query name: where[parent_uuid] required: false schema: type: string - description: Rango >= de `parent_uuid`. in: query name: parent_uuid_gte required: false schema: type: string - description: Rango <= de `parent_uuid`. in: query name: parent_uuid_lte required: false schema: type: string - description: Filtro por igualdad de `slug`. in: query name: where[slug] required: false schema: type: string - description: Rango >= de `slug`. in: query name: slug_gte required: false schema: type: string - description: Rango <= de `slug`. in: query name: slug_lte required: false schema: type: string responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Listar categories tags: - v1 - categories x-fleetbase-source: docs/09 §1 post: operationId: crear_v1_categories_post parameters: - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '201': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Crear categories tags: - v1 - categories x-fleetbase-source: docs/09 §1 /v1/categories/bulk-delete: delete: operationId: borrado_masivo_v1_categories_bulk_delete_delete parameters: - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret requestBody: content: application/json: schema: oneOf: - items: type: string type: array - properties: ids: items: type: string type: array required: - ids type: object required: true responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Borrado masivo de categories tags: - v1 - categories x-fleetbase-source: docs/09 §1 /v1/categories/{id}: delete: operationId: borrar_v1_categories__id__delete parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '204': description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error summary: Borrar categories (soft-delete) tags: - v1 - categories x-fleetbase-source: docs/09 §1 get: operationId: detalle_v1_categories__id__get parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Detalle de categories tags: - v1 - categories x-fleetbase-source: docs/09 §1 patch: operationId: editar_patch_v1_categories__id__patch parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar categories (PATCH) tags: - v1 - categories x-fleetbase-source: docs/09 §1 put: operationId: editar_put_v1_categories__id__put parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar categories (PUT) tags: - v1 - categories x-fleetbase-source: docs/09 §1 /v1/groups: get: operationId: listar_v1_groups_get parameters: - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret - description: Búsqueda de texto sobre los campos declarados. in: query name: query required: false schema: type: string - in: query name: limit required: false schema: default: 25 maximum: 100 minimum: 1 type: integer - in: query name: offset required: false schema: default: 0 minimum: 0 type: integer - description: Campos separados por coma; prefijo `-` para descendente. in: query name: sort required: false schema: type: string - description: 'Relaciones declaradas: ninguna' in: query name: with required: false schema: type: string - description: Filtro por igualdad de `created_at`. in: query name: where[created_at] required: false schema: type: string - description: Rango >= de `created_at`. in: query name: created_at_gte required: false schema: type: string - description: Rango <= de `created_at`. in: query name: created_at_lte required: false schema: type: string - description: Filtro por igualdad de `name`. in: query name: where[name] required: false schema: type: string - description: Rango >= de `name`. in: query name: name_gte required: false schema: type: string - description: Rango <= de `name`. in: query name: name_lte required: false schema: type: string - description: Filtro por igualdad de `slug`. in: query name: where[slug] required: false schema: type: string - description: Rango >= de `slug`. in: query name: slug_gte required: false schema: type: string - description: Rango <= de `slug`. in: query name: slug_lte required: false schema: type: string responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Listar groups tags: - v1 - groups x-fleetbase-source: docs/09 §1 post: operationId: crear_v1_groups_post parameters: - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '201': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Crear groups tags: - v1 - groups x-fleetbase-source: docs/09 §1 /v1/groups/bulk-delete: delete: operationId: borrado_masivo_v1_groups_bulk_delete_delete parameters: - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret requestBody: content: application/json: schema: oneOf: - items: type: string type: array - properties: ids: items: type: string type: array required: - ids type: object required: true responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Borrado masivo de groups tags: - v1 - groups x-fleetbase-source: docs/09 §1 /v1/groups/{id}: delete: operationId: borrar_v1_groups__id__delete parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '204': description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error summary: Borrar groups (soft-delete) tags: - v1 - groups x-fleetbase-source: docs/09 §1 get: operationId: detalle_v1_groups__id__get parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Detalle de groups tags: - v1 - groups x-fleetbase-source: docs/09 §1 patch: operationId: editar_patch_v1_groups__id__patch parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar groups (PATCH) tags: - v1 - groups x-fleetbase-source: docs/09 §1 put: operationId: editar_put_v1_groups__id__put parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar groups (PUT) tags: - v1 - groups x-fleetbase-source: docs/09 §1 /v1/places: get: operationId: listar_v1_places_get parameters: - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret - description: Búsqueda de texto sobre los campos declarados. in: query name: query required: false schema: type: string - in: query name: limit required: false schema: default: 25 maximum: 100 minimum: 1 type: integer - in: query name: offset required: false schema: default: 0 minimum: 0 type: integer - description: Campos separados por coma; prefijo `-` para descendente. in: query name: sort required: false schema: type: string - description: 'Relaciones declaradas: ninguna' in: query name: with required: false schema: type: string - description: Filtro por igualdad de `city`. in: query name: where[city] required: false schema: type: string - description: Rango >= de `city`. in: query name: city_gte required: false schema: type: string - description: Rango <= de `city`. in: query name: city_lte required: false schema: type: string - description: Filtro por igualdad de `country`. in: query name: where[country] required: false schema: type: string - description: Rango >= de `country`. in: query name: country_gte required: false schema: type: string - description: Rango <= de `country`. in: query name: country_lte required: false schema: type: string - description: Filtro por igualdad de `name`. in: query name: where[name] required: false schema: type: string - description: Rango >= de `name`. in: query name: name_gte required: false schema: type: string - description: Rango <= de `name`. in: query name: name_lte required: false schema: type: string - description: Filtro por igualdad de `owner_uuid`. in: query name: where[owner_uuid] required: false schema: type: string - description: Rango >= de `owner_uuid`. in: query name: owner_uuid_gte required: false schema: type: string - description: Rango <= de `owner_uuid`. in: query name: owner_uuid_lte required: false schema: type: string - description: Filtro por igualdad de `type`. in: query name: where[type] required: false schema: type: string - description: Rango >= de `type`. in: query name: type_gte required: false schema: type: string - description: Rango <= de `type`. in: query name: type_lte required: false schema: type: string responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Listar places tags: - v1 - places x-fleetbase-source: docs/09 §1 post: operationId: crear_v1_places_post parameters: - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '201': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Crear places tags: - v1 - places x-fleetbase-source: docs/09 §1 /v1/places/bulk-delete: delete: operationId: borrado_masivo_v1_places_bulk_delete_delete parameters: - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret requestBody: content: application/json: schema: oneOf: - items: type: string type: array - properties: ids: items: type: string type: array required: - ids type: object required: true responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Borrado masivo de places tags: - v1 - places x-fleetbase-source: docs/09 §1 /v1/places/{id}: delete: operationId: borrar_v1_places__id__delete parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '204': description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error summary: Borrar places (soft-delete) tags: - v1 - places x-fleetbase-source: docs/09 §1 get: operationId: detalle_v1_places__id__get parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Detalle de places tags: - v1 - places x-fleetbase-source: docs/09 §1 patch: operationId: editar_patch_v1_places__id__patch parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar places (PATCH) tags: - v1 - places x-fleetbase-source: docs/09 §1 put: operationId: editar_put_v1_places__id__put parameters: - in: path name: id required: true schema: title: Id type: string - in: header name: X-API-KEY required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: X-API-SECRET required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Secret responses: '200': content: application/json: schema: {} description: Successful Response '401': content: application/problem+json: schema: type: object description: Unauthorized '404': content: application/problem+json: schema: type: object description: Not Found '409': content: application/problem+json: schema: type: object description: Conflict '422': content: application/problem+json: schema: type: object description: Unprocessable Entity summary: Editar places (PUT) tags: - v1 - places x-fleetbase-source: docs/09 §1