Ingest entities into Port via the REST API and map blueprints

Steps

1. Obtain a Port API token by posting your clientId and clientSecret to https://api.getport.io/v1/auth/access_token and extracting the accessToken from the response.
2. Define a blueprint in Port (via UI or API) representing the entity type you want to ingest, with identifier, title, and a schema properties object describing each field.
3. Upsert an entity with POST https://api.getport.io/v1/blueprints/{blueprint_identifier}/entities?upsert=true&merge=true, passing a JSON body with identifier, title, and properties matching the blueprint schema.
4. To upsert in bulk, loop over your data set and make one POST per entity, or use the Port ocean framework or an official integration for higher-throughput ingestion.
5. Verify the entity appears in the Port catalog UI under its blueprint and confirm all properties are populated as expected.
6. Set up relations in the blueprint definition to link entities across blueprints (e.g., linking a Service entity to a Team entity) and populate them in the entity body under the relations key.