How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Seventh Sense Persons API

Persons are registered persons that you can later search for using face images. Registering a person allows you to search for them later using the `/search` endpoint. You can also use the `/person` endpoint(s) to update the registered person's name and/or add additional images to the registered person. Registering a person stores thumbnail face images and information on our servers. You can delete a registered person using the `DELETE /person/{person_id}` endpoint.

Seventh Sense Persons API is one of 5 APIs that Seventh Sense publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Persons. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 11 operations across 7 paths, and defines 17 schemas. It is described by OpenAPI 3.2.0, at version 2026.07.15.0759.

Requests are made against a single base URL, https://us.opencv.fr.

11 operations 7 paths 17 schemas 2 DELETE3 GET3 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026.07.15.0759
Base URL
https://us.opencv.fr
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Seventh Sense Persons API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (APIKeyHeader).

Paths & Operations 11

Across 7 paths, the API surfaces 11 operations — 2 DELETE, 3 GET, 3 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Persons 11

Persons are registered persons that you can later search for using face images. Registering a person allows you to search for them later using the /search endpoint. You can also u…

GET
/person/{person_id}
Get Person
get_person_person__person_id__get 1 param → 200422
DELETE
/person/{person_id}
Delete Person
delete_person_person__person_id__delete 1 param → 200422
PATCH
/persons
Modify Persons
modify_persons_persons_patch body → 200422
GET
/persons
Get Persons
get_persons_persons_get 5 params → 200422
POST
/person
Create Person
create_person_person_post body → 201422
PATCH
/person
Update Person
update_person_person_patch body → 200422
POST
/person/crops
Create Person From Crops Obtained Using Detect End Point
create_person_from_crops_obtained_using_detect_end_point_person_crops_post body → 201422
POST
/person/images
Add Thumbnails From Images
add_thumbnails_from_images_person_images_post body → 201422
PATCH
/person/images
Update Person And Add New Images While Removing Old Ones
update_person_and_add_new_images_while_removing_old_ones_person_images_patch body → 200422
DELETE
/person/image/{person_id}/{thumbnail_id}
Delete An Existing Thumbnail
delete_an_existing_thumbnail_person_image__person_id___thumbnail_id__delete 2 params → 200422
GET
/persons/{collection_id}
Get Persons In Collection
get_persons_in_collection_persons__collection_id__get 6 params → 200422

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are PersonSchema (10 properties), UpdatePersonAndImagesSchema (9 properties), CreatePersonSchema (9 properties), UpdatePersonSchema (8 properties). Each schema is shown below with its type and property counts.

OrderEnum
string
CollectionSchema
object
6 properties 5 required
ThumbnailSchema
object
2 properties 1 required
CreateImagesSchema
object
2 properties 2 required
CreateImageResponseSchema
object
3 properties 3 required
UpdatePersonAndImagesSchema
object
9 properties 1 required
ValidationError
object
3 properties 3 required
GenderEnum
string
ListPersonsSchema
object
2 properties 2 required
PersonsOrderByEnum
string
UpdatePersonSchema
object
8 properties 1 required
CreatePersonSchema
object
9 properties 1 required
PersonSchema
object
10 properties 4 required
DeletedItemSchema
object
1 property
ActionEnum
string
HTTPValidationError
object
1 property
DeletePersonsSchema
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

seventh-sense-persons-api-openapi.yml Raw ↑

Other APIs Seventh Sense publishes across the network.

Seventh Sense Collections API
Seventh Sense Face Anti-Spoofing / Liveness API
Seventh Sense Face Verification API
Seventh Sense Search API
Where this information came from

This is an independent, third-party profile of Seventh Sense Persons API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.