Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

RWTH Aachen University Self API

Endpoints for the current authenticated user.

RWTH Aachen University Self API is one of 49 APIs that RWTH Aachen University publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Self. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and 3 JSON Schemas.

This API exposes 11 operations across 8 paths, and defines 22 schemas. It is described by OpenAPI 3.0.1, at version 2.0.

Requests are made against a single base URL, https://coscine.rwth-aachen.de/coscine.

11 operations 8 paths 22 schemas 1 DELETE2 GET1 OPTIONS6 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2.0
Base URL
https://coscine.rwth-aachen.de/coscine/api/
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

RWTH Aachen University Self API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Bearer). By default, every request must be authenticated.

  • Bearer — JWT Authorization header using the Bearer scheme.

Paths & Operations 11

Across 8 paths, the API surfaces 11 operations — 1 DELETE, 2 GET, 1 OPTIONS, 6 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Self 11

Endpoints for the current authenticated user.

GET
/api/v2/self
Retrieves the current authenticated user.
GetCurrentUser → 200
PUT
/api/v2/self
Updates the current authenticated user.
UpdateCurrentUser body → 204404
DELETE
/api/v2/self
Deletes the current authenticated user.
DeleteCurrentUser → 204404409
OPTIONS
/api/v2/self
Responds with the HTTP methods allowed for the endpoint.
→ 200
POST
/api/v2/self/tos
Accepts the current Terms Of Service for the current authenticated user.
AcceptCurrentTos body → 204404
POST
/api/v2/self/emails
Confirms the email of a user.
ConfirmUserEmail 1 param → 204404400
POST
/api/v2/self/emails/resend
Resends the confirmation email for a user.
ResendUserEmailConfirmation → 204400429
POST
/api/v2/self/identities
Initiates user merging for the current user.
InitiateUserMerge 1 param → 200400
POST
/api/v2/self/project-invitations
Resolves a project invitation for the authenticated user.
ResolveProjectInvitation body → 403400404
POST
/api/v2/self/data-proccessing-consent
Gives the consent for data processing for the current authenticated user.
GiveDataProcessingConsent → 204404
GET
/api/v2/self/active-project-roles-count
Retrieves the number of active project roles for the currently authenticated user.
GetActiveProjectRolesCount → 200

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are UserDto (14 properties), UserForUpdateDto (7 properties), UserOrganizationDto (5 properties), ProblemDetails (5 properties). Each schema is shown below with its type and property counts.

DisciplineForUserManipulationDto
object
Data transfer object (DTO) representing a discipline for user manipulation.
1 property 1 required
UserTermsOfServiceAcceptDto
object
Represents the data transfer object (DTO) for accepting the terms of service by a user.
1 property 1 required
IdentityProviderDto
object
Represents a Data Transfer Object (DTO) for an identity provider.
2 properties 2 required
UserProjectRoleCountDto
object
Represents a Data Transfer Object containing the number of active project roles for a user.
1 property
TitleForUserManipulationDto
object
Represents the data transfer object (DTO) for manipulating a user's title.
1 property 1 required
UserProjectRoleCountDtoResponse
object
4 properties
DefaultOrganizationQuotaDto
object
Represents the default quota of an organization.
3 properties
UserEmailDto
object
Represents a Data Transfer Object (DTO) for user email information.
3 properties
LanguageForUserManipulationDto
object
Data transfer object (DTO) representing a language for user manipulation.
1 property 1 required
TitleDto
object
Represents the Data Transfer Object (DTO) for title information.
2 properties 2 required
CoscineRoleDto
object
Data Transfer Object (DTO) that represents a user role within Coscine.///
1 property 1 required
ProjectInvitationResolveDto
object
Data transfer object (DTO) for resolving a project invitation.
1 property 1 required
ProblemDetails
object
5 properties
UserDtoResponse
object
4 properties
UserForUpdateDto
object
Represents the data transfer object (DTO) for updating user details.
7 properties 5 required
UserDto
object
Represents a Data Transfer Object (DTO) for user-related information.
14 properties 7 required
UserMergeDto
object
Represents a Data Transfer Object (DTO) for merging user accounts.
1 property 1 required
UserOrganizationDto
object
Represents a Data Transfer Object (DTO) for user-related organization information, inheriting from OrganizationDto.
5 properties 2 required
DisciplineDto
object
Represents the data transfer object for a discipline.
4 properties
UserMergeDtoResponse
object
4 properties
IdentityProviders
string
Specifies the supported external authentication services.
LanguageDto
object
Represents a Data Transfer Object (DTO) for language details.
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rwth-aachen-university-self-api-openapi.yml Raw ↑

Other APIs RWTH Aachen University publishes across the network.

RWTH Publications OAI-PMH
RWTH Single Sign-On (OAuth2 / OpenID Connect / Shibboleth)
RWTH Aachen University Admin API
RWTH Aachen University ApplicationProfile API
RWTH Aachen University Blob API
RWTH Aachen University DataHamsterReport API
RWTH Aachen University Discipline API
RWTH Aachen University Graph API
RWTH Aachen University GraphMetadata API
RWTH Aachen University GraphMetadataContent API
RWTH Aachen University Handle API
RWTH Aachen University Language API