|
11 | 11 | }, |
12 | 12 | "servers": [ |
13 | 13 | { |
14 | | - "url": "https://cveawg-dev.mitre.org/api" |
| 14 | + "url": "urlplaceholder" |
15 | 15 | } |
16 | 16 | ], |
17 | 17 | "paths": { |
|
2080 | 2080 | }, |
2081 | 2081 | "example": { |
2082 | 2082 | "short_name": "fake_company", |
2083 | | - "name": "Fake Company", |
2084 | | - "hard_quota": 1000, |
| 2083 | + "long_name": "Fake Company", |
| 2084 | + "id_quota": 1000, |
2085 | 2085 | "authority": [ |
2086 | 2086 | "CNA" |
2087 | 2087 | ] |
|
2140 | 2140 | "users": [ |
2141 | 2141 | { |
2142 | 2142 | "UUID": "fe566221-6a2c-4279-8800-4d3795325997", |
2143 | | - "org_UUID": "9e243a41-352b-426a-9dfd-f664b4c71e80", |
2144 | 2143 | "username": "jdoe", |
2145 | 2144 | "name": { |
2146 | 2145 | "first": "John", |
2147 | 2146 | "last": "Doe" |
2148 | 2147 | }, |
2149 | 2148 | "role": "ADMIN", |
2150 | | - "is_active": true, |
2151 | | - "time": { |
2152 | | - "created": "2021-02-12T17:15:37.382Z", |
2153 | | - "modified": "2021-02-12T17:15:37.382Z" |
2154 | | - } |
| 2149 | + "status": "active", |
| 2150 | + "created": "2021-02-12T17:15:37.382Z", |
| 2151 | + "last_updated": "2021-02-12T17:15:37.382Z" |
2155 | 2152 | } |
2156 | 2153 | ] |
2157 | 2154 | } |
|
2211 | 2208 | } |
2212 | 2209 | } |
2213 | 2210 | }, |
2214 | | - "/registry/org/{shortname}/hard_quota": { |
| 2211 | + "/registry/org/{shortname}/id_quota": { |
2215 | 2212 | "get": { |
2216 | 2213 | "tags": [ |
2217 | 2214 | "Registry Organization" |
2218 | 2215 | ], |
2219 | 2216 | "summary": "Retrieves an organization's CVE ID quota (accessible to all registered users)", |
2220 | 2217 | "description": " <h2>Access Control</h2> <p>All registered users can access this endpoint</p> <h2>Expected Behavior</h2> <p><b>Regular, CNA & Admin Users:</b> Retrieves the CVE ID quota for the user's organization</p> <p><b>Secretariat:</b> Retrieves the CVE ID quota for any organization</p>", |
2221 | | - "operationId": "orgHardQuota", |
| 2218 | + "operationId": "orgIdQuota", |
2222 | 2219 | "parameters": [ |
2223 | 2220 | { |
2224 | 2221 | "name": "shortname", |
|
2542 | 2539 | "application/json": { |
2543 | 2540 | "schema": { |
2544 | 2541 | "$ref": "../schemas/registry-user/update-registry-user-response.json" |
| 2542 | + }, |
| 2543 | + "example": { |
| 2544 | + "message": "jdoe was successfully updated.", |
| 2545 | + "updated": { |
| 2546 | + "UUID": "fe566221-6a2c-4279-8800-4d3795325997", |
| 2547 | + "username": "jdoe", |
| 2548 | + "name": { |
| 2549 | + "first": "John", |
| 2550 | + "last": "Doe" |
| 2551 | + }, |
| 2552 | + "status": "active", |
| 2553 | + "created": "2021-02-12T17:15:37.382Z", |
| 2554 | + "last_updated": "2021-02-12T17:15:37.382Z" |
| 2555 | + } |
2545 | 2556 | } |
2546 | 2557 | } |
2547 | 2558 | } |
|
2605 | 2616 | "Registry Organization" |
2606 | 2617 | ], |
2607 | 2618 | "summary": "Updates information about the organization specified by short name (accessible Temporarily to Secretariat only)", |
2608 | | - "description": " <h2>Access Control</h2> <p>User must belong to an organization with the <b>Secretariat</b> role temporarily.</p> <p>In the future, only the organization's admin will be able to request changes to its information.</p> <p>With Joint Approval required for the following fields:</p> <h2>Expected Behavior</h2> <b>This endpoint expects a full organization object in the request body.</b> <p><b>Secretariat:</b> Updates any organization's information</p> <p><b>Organization Admin:</b> Requests changes to its organization's information</p> <ul> <li>short_name</li> <li>long_name</li> <li>authority</li> <li>aliases</li> <li>oversees</li> <li>top_level_root</li> <li>charter_or_scope</li> <li>product_list</li> <li>disclosure_policy</li> <li>contact_info.websites</li> <li>contact_info.emails</li> <li>contact_info.phone</li> <li>partner_role_type</li> <li>partner_country</li> <li>advisory_locations</li> <li>industry</li> <li>tl_root_start_date</li> <li>is_cna_discussion_list</li> </ul>", |
| 2619 | + "description": " <h2>Access Control</h2> <p>User must belong to an organization with the <b>Secretariat</b> role temporarily.</p> <p>In the future, only the organization's admin will be able to request changes to its information.</p> <p>With Joint Approval required for the following fields:</p> <h2>Expected Behavior</h2> <b>This endpoint expects a full organization object in the request body.</b> <p><b>Secretariat:</b> Updates any organization's information</p> <p><b>Organization Admin:</b> Requests changes to its organization's information</p> <ul> <li>short_name</li> <li>long_name</li> <li>authority</li> <li>aliases</li> <li>oversees</li> <li>top_level_root</li> <li>charter_or_scope</li> <li>product_list</li> <li>disclosure_policy</li> <li>contact_info.websites</li> <li>contact_info.emails</li> <li>contact_info.phone</li> <li>partner_role_type</li> <li>partner_country</li> <li>advisory_locations</li> <li>advisory_location_require_credentials</li> <li>vulnerability_advisory_location_for_web_scraping</li> <li>industry</li> <li>tl_root_start_date</li> <li>is_cna_discussion_list</li> </ul>", |
2609 | 2620 | "operationId": "orgUpdateSingle", |
2610 | 2621 | "parameters": [ |
2611 | 2622 | { |
|
2698 | 2709 | }, |
2699 | 2710 | "example": { |
2700 | 2711 | "short_name": "fake_company", |
2701 | | - "name": "Fake Company", |
2702 | | - "hard_quota": 1000, |
| 2712 | + "long_name": "Fake Company", |
| 2713 | + "id_quota": 1000, |
2703 | 2714 | "authority": [ |
2704 | 2715 | "CNA" |
2705 | 2716 | ] |
|
2745 | 2756 | "schema": { |
2746 | 2757 | "$ref": "../schemas/registry-user/create-registry-user-response.json" |
2747 | 2758 | } |
| 2759 | + }, |
| 2760 | + "example": { |
| 2761 | + "message": "jdoe was successfully created.", |
| 2762 | + "created": { |
| 2763 | + "UUID": "fe566221-6a2c-4279-8800-4d3795325997", |
| 2764 | + "username": "jdoe", |
| 2765 | + "name": { |
| 2766 | + "first": "John", |
| 2767 | + "last": "Doe" |
| 2768 | + }, |
| 2769 | + "status": "active", |
| 2770 | + "secret": "12345-abcde-67890", |
| 2771 | + "created": "2021-02-12T17:15:37.382Z", |
| 2772 | + "last_updated": "2021-02-12T17:15:37.382Z" |
| 2773 | + } |
2748 | 2774 | } |
2749 | 2775 | } |
2750 | 2776 | }, |
|
2806 | 2832 | "schema": { |
2807 | 2833 | "$ref": "../schemas/registry-user/create-registry-user-request.json" |
2808 | 2834 | } |
| 2835 | + }, |
| 2836 | + "example": { |
| 2837 | + "username": "jdoe", |
| 2838 | + "name": { |
| 2839 | + "first": "John", |
| 2840 | + "last": "Doe" |
| 2841 | + } |
2809 | 2842 | } |
2810 | 2843 | } |
2811 | 2844 | } |
|
3575 | 3608 | }, |
3576 | 3609 | "description": "The shortname of the organization" |
3577 | 3610 | }, |
| 3611 | + { |
| 3612 | + "name": "registry", |
| 3613 | + "in": "query", |
| 3614 | + "schema": { |
| 3615 | + "type": "string" |
| 3616 | + } |
| 3617 | + }, |
3578 | 3618 | { |
3579 | 3619 | "$ref": "#/components/parameters/id_quota" |
3580 | 3620 | }, |
|
4522 | 4562 | "application/json": { |
4523 | 4563 | "schema": { |
4524 | 4564 | "$ref": "../schemas/conversation/list-conversations-response.json" |
| 4565 | + }, |
| 4566 | + "example": { |
| 4567 | + "totalCount": 1, |
| 4568 | + "itemsPerPage": 10, |
| 4569 | + "pageCount": 1, |
| 4570 | + "currentPage": 1, |
| 4571 | + "prevPage": null, |
| 4572 | + "nextPage": null, |
| 4573 | + "conversations": [ |
| 4574 | + { |
| 4575 | + "UUID": "c8a41738-f9d6-4447-9755-9ab0101b7a2d", |
| 4576 | + "target_uuid": "123e4567-e89b-12d3-a456-426614174000", |
| 4577 | + "author_id": "fe566221-6a2c-4279-8800-4d3795325997", |
| 4578 | + "author_name": "John Doe", |
| 4579 | + "body": "This is a conversation message.", |
| 4580 | + "posted_at": "2021-02-12T17:15:37.382Z" |
| 4581 | + } |
| 4582 | + ] |
4525 | 4583 | } |
4526 | 4584 | } |
4527 | 4585 | } |
|
4622 | 4680 | "application/json": { |
4623 | 4681 | "schema": { |
4624 | 4682 | "$ref": "../schemas/conversation/list-conversations-response.json" |
| 4683 | + }, |
| 4684 | + "example": { |
| 4685 | + "totalCount": 1, |
| 4686 | + "itemsPerPage": 10, |
| 4687 | + "pageCount": 1, |
| 4688 | + "currentPage": 1, |
| 4689 | + "prevPage": null, |
| 4690 | + "nextPage": null, |
| 4691 | + "conversations": [ |
| 4692 | + { |
| 4693 | + "UUID": "c8a41738-f9d6-4447-9755-9ab0101b7a2d", |
| 4694 | + "target_uuid": "123e4567-e89b-12d3-a456-426614174000", |
| 4695 | + "author_id": "fe566221-6a2c-4279-8800-4d3795325997", |
| 4696 | + "author_name": "John Doe", |
| 4697 | + "body": "This is a conversation message.", |
| 4698 | + "posted_at": "2021-02-12T17:15:37.382Z" |
| 4699 | + } |
| 4700 | + ] |
4625 | 4701 | } |
4626 | 4702 | } |
4627 | 4703 | } |
|
4712 | 4788 | "application/json": { |
4713 | 4789 | "schema": { |
4714 | 4790 | "$ref": "../schemas/conversation/conversation.json" |
| 4791 | + }, |
| 4792 | + "example": { |
| 4793 | + "UUID": "c8a41738-f9d6-4447-9755-9ab0101b7a2d", |
| 4794 | + "target_uuid": "123e4567-e89b-12d3-a456-426614174000", |
| 4795 | + "author_id": "fe566221-6a2c-4279-8800-4d3795325997", |
| 4796 | + "author_name": "John Doe", |
| 4797 | + "body": "This is a conversation message.", |
| 4798 | + "posted_at": "2021-02-12T17:15:37.382Z" |
4715 | 4799 | } |
4716 | 4800 | } |
4717 | 4801 | } |
|
4782 | 4866 | "required": [ |
4783 | 4867 | "body" |
4784 | 4868 | ] |
| 4869 | + }, |
| 4870 | + "example": { |
| 4871 | + "body": "This is a conversation message." |
4785 | 4872 | } |
4786 | 4873 | } |
4787 | 4874 | } |
|
4823 | 4910 | "application/json": { |
4824 | 4911 | "schema": { |
4825 | 4912 | "$ref": "../schemas/conversation/conversation.json" |
| 4913 | + }, |
| 4914 | + "example": { |
| 4915 | + "UUID": "c8a41738-f9d6-4447-9755-9ab0101b7a2d", |
| 4916 | + "target_uuid": "123e4567-e89b-12d3-a456-426614174000", |
| 4917 | + "author_id": "fe566221-6a2c-4279-8800-4d3795325997", |
| 4918 | + "author_name": "John Doe", |
| 4919 | + "body": "This is an updated conversation message.", |
| 4920 | + "visibility": "public", |
| 4921 | + "posted_at": "2021-02-12T17:15:37.382Z", |
| 4922 | + "edited_at": "2021-02-12T17:20:00.000Z" |
4826 | 4923 | } |
4827 | 4924 | } |
4828 | 4925 | } |
|
4898 | 4995 | "description": "The updated visibility of the conversation message" |
4899 | 4996 | } |
4900 | 4997 | } |
| 4998 | + }, |
| 4999 | + "example": { |
| 5000 | + "body": "This is an updated conversation message.", |
| 5001 | + "visibility": "public" |
4901 | 5002 | } |
4902 | 5003 | } |
4903 | 5004 | } |
|
4939 | 5040 | "application/json": { |
4940 | 5041 | "schema": { |
4941 | 5042 | "$ref": "../schemas/review/review.json" |
| 5043 | + }, |
| 5044 | + "example": { |
| 5045 | + "uuid": "c8a41738-f9d6-4447-9755-9ab0101b7a2d", |
| 5046 | + "target_object_uuid": "123e4567-e89b-12d3-a456-426614174000", |
| 5047 | + "status": "PENDING", |
| 5048 | + "new_review_data": { |
| 5049 | + "name": "New Organization Name" |
| 5050 | + }, |
| 5051 | + "created": "2021-02-12T17:15:37.382Z", |
| 5052 | + "last_updated": "2021-02-12T17:15:37.382Z" |
4942 | 5053 | } |
4943 | 5054 | } |
4944 | 5055 | } |
|
5031 | 5142 | "application/json": { |
5032 | 5143 | "schema": { |
5033 | 5144 | "$ref": "../schemas/review/review.json" |
| 5145 | + }, |
| 5146 | + "example": { |
| 5147 | + "uuid": "c8a41738-f9d6-4447-9755-9ab0101b7a2d", |
| 5148 | + "target_object_uuid": "123e4567-e89b-12d3-a456-426614174000", |
| 5149 | + "status": "PENDING", |
| 5150 | + "new_review_data": { |
| 5151 | + "name": "New Organization Name" |
| 5152 | + }, |
| 5153 | + "created": "2021-02-12T17:15:37.382Z", |
| 5154 | + "last_updated": "2021-02-12T17:15:37.382Z" |
5034 | 5155 | } |
5035 | 5156 | } |
5036 | 5157 | } |
|
5130 | 5251 | "application/json": { |
5131 | 5252 | "schema": { |
5132 | 5253 | "$ref": "../schemas/review/list-reviews-response.json" |
| 5254 | + }, |
| 5255 | + "example": { |
| 5256 | + "totalCount": 1, |
| 5257 | + "itemsPerPage": 100, |
| 5258 | + "pageCount": 1, |
| 5259 | + "currentPage": 1, |
| 5260 | + "prevPage": null, |
| 5261 | + "nextPage": null, |
| 5262 | + "reviews": [ |
| 5263 | + { |
| 5264 | + "uuid": "c8a41738-f9d6-4447-9755-9ab0101b7a2d", |
| 5265 | + "target_object_uuid": "123e4567-e89b-12d3-a456-426614174000", |
| 5266 | + "status": "PENDING", |
| 5267 | + "new_review_data": { |
| 5268 | + "name": "New Organization Name" |
| 5269 | + }, |
| 5270 | + "created": "2021-02-12T17:15:37.382Z", |
| 5271 | + "last_updated": "2021-02-12T17:15:37.382Z" |
| 5272 | + } |
| 5273 | + ] |
5133 | 5274 | } |
5134 | 5275 | } |
5135 | 5276 | } |
|
5330 | 5471 | "application/json": { |
5331 | 5472 | "schema": { |
5332 | 5473 | "$ref": "../schemas/review/review.json" |
| 5474 | + }, |
| 5475 | + "example": { |
| 5476 | + "uuid": "c8a41738-f9d6-4447-9755-9ab0101b7a2d", |
| 5477 | + "target_object_uuid": "123e4567-e89b-12d3-a456-426614174000", |
| 5478 | + "status": "PENDING", |
| 5479 | + "new_review_data": { |
| 5480 | + "name": "New Organization Name" |
| 5481 | + }, |
| 5482 | + "created": "2021-02-12T17:15:37.382Z", |
| 5483 | + "last_updated": "2021-02-12T17:15:37.382Z" |
5333 | 5484 | } |
5334 | 5485 | } |
5335 | 5486 | } |
|
5392 | 5543 | "schema": { |
5393 | 5544 | "type": "object", |
5394 | 5545 | "description": "The updated review data" |
| 5546 | + }, |
| 5547 | + "example": { |
| 5548 | + "new_review_data": { |
| 5549 | + "name": "New Organization Name" |
| 5550 | + } |
5395 | 5551 | } |
5396 | 5552 | } |
5397 | 5553 | } |
|
5433 | 5589 | "application/json": { |
5434 | 5590 | "schema": { |
5435 | 5591 | "$ref": "../schemas/review/review.json" |
| 5592 | + }, |
| 5593 | + "example": { |
| 5594 | + "uuid": "c8a41738-f9d6-4447-9755-9ab0101b7a2d", |
| 5595 | + "target_object_uuid": "123e4567-e89b-12d3-a456-426614174000", |
| 5596 | + "status": "PENDING", |
| 5597 | + "new_review_data": { |
| 5598 | + "name": "New Organization Name" |
| 5599 | + }, |
| 5600 | + "created": "2021-02-12T17:15:37.382Z", |
| 5601 | + "last_updated": "2021-02-12T17:15:37.382Z" |
5436 | 5602 | } |
5437 | 5603 | } |
5438 | 5604 | } |
|
0 commit comments